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1.0  The  3FCHEX  Program 

For  many  years  it  has  been  the  practice  of  computer  systems  to 
"su^ly  a  certain  amount"  of  diagnostic  control  in  the"  assembly  or  coimpiTatibn 
of  computer  programs.  This  control  generally  consists  in  the  identification 
of  duplicate  tags,  illegal  instructions,  invalid  logical  procedures  and  the 
like.  However,  this  type  of  dieignostic  aid  is  designed  to  assist  the  pro¬ 
grammer  only  up  to  that  time  at  which  the  computer  is  able  to  interpret  and 
execute  the  instruction  sequences.  When  the  programmer  begins  to  check  out 
the  computer  program  for  the  desired  results,  he  is  often  left  with  little 
aid  in  the  form  of  diagnostic  routines.  Even  those  which  are  available  (such 
as  dumps  and  trace  routines)  axe  not  available  at  any  selected  point  in  the 
user's  program  unless  the  user  modify  his  program  by  inserting  some  sort  of 
call ing  sequence. 

It  is  this  situation  that  SFCHEX  is  intended  to  remedy  in  the  cjwe 
of  the  Bird  Buffer  System.  SFCHEX  will  allow  the  user  to  dunq)  any  portion 
of  his  program  at  any  time.  He  will  be  able  to  modify  peu^eters  or  in¬ 
structions  as  he  desires.  He  may  Jump  from  point  to  point  in  his  program. 
Annotations  for  output  (e.g.  dumps)  cam  be  generated.  All  these  can  be 
effected  without  the  user  modifying  any  portion  of  his  program.  The  ultimate 
speed  up  in  the  checkout  of  programs  euid  the  added  efficiency,  in  the  fact 
that  numerous  assemblies  cuid  compilations  to  add  or  remove  diagnostic  duiiq>s 
are  no  longer  needed,  is  evident. 

SFCHEX  performs  this  function  by  accepting  directions  (i.e.,  commands) 
via  the  typewriter  or  on-line  card  reader.  These  commands  instruct  SFCHEX 
as  to  where  and  when  corrections,  dumps  or  annotations  are  to  be  made.  The 
key  command  for  SFCHEX  is  the  TBAP  Commsuid.  It  enables  the  user  to  Iterate 
a  certain  set  of  conmands  as  many  times  ob  he  wishes  and  after  the  final 
iteration,  the  "flushing"  (i.e.,  elimination)  of  the  TRAP  Command  will  result 
in  em  interrogation  of  the  typewriter  (or  card  reesier)  for  more  comnands. 
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Before  explaining  the  method  euid  philosophy  of  the  program  further, 
we  shall  now  consider  the  input  formats  (Section  2.0),  the  output  formats 
(section  3.0)  and  the  operating  instructions  (Section  4.0).  Section  5-0 
(SFCHEC  Capability)  will  then  develop  further  the  method  of  SFCHEX  and  dis¬ 
cuss  the  use  and  strategy  of  the  various  commands  with  en5)hasis  on  the  TRAP 
Command. 


Section  6.0  will  be  the  listing  of  the  validation  and  checkout 
procedures  and  Section  7.0  is  a  description  of  each  subroutine  and  logical 
section  of  SFCHEX  including  both  descriptions  and  flowcharts. 
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2.0  INPUT 

2.1  Input  Modes 

SFCHEX  allows  two  modes  of  input.  Commands  may  be  entered  via  the 
typewriter  or  the  on-line  card  reader.  SFCHEX  will  request  the  input  option 
by  printing  on  the  typewriter:  MODE  IN. 

The  user  will  then  indicate  his  option  by  typing  a  "T"  for  typewriter 
input  or  a  ”C"  for  punched  card  input.  Input  formats  axe  the  same  for  both 
modes  of  input.  In  both  types  of  input  a  period  will  be  used  to  terminate 
the  command.  In  the  typewriter  input  mode  SFCHEX  causes  a  carriage  return 
and  types  an  whenever  it  is  ready  to  accept  another  command.  If  the  final 
period  for  a  command  has  not  yet  been  typed  the  user  can  delete  the  command 
by  causing  a  carriage  return.  In  the  on-line  card  read  mode  SFCHEX  reads  one 
card  each  time  it  is  prepared  to  accept  another  command. 

2.2  Input  Commands 

There  are  twelve  different  commands  which  SFCHEX  will  accept  and 
execute.  Each  command  is  Identified  by  a  letter  which  is  the  initial  letter 
of  the  command  name.  The  following  is  a  list  of  the  command  names  and  a 
description  of  the  function  which  each  will  perform.  Please  note  all  euidresses 
and  parameters  are  entered  in  octal. 

2.2.1  Conmand  Types 

2. 2. 1.1  Begin  Command 

This  command  is  used  to  indicate  to  the  SFCHEX  program  that  all  of 
the  initial  cominands  have  been  entered.  SFCHEX  will  transfer  to  the  address 
contained  in  the  Begin  Command. (This  address  will  normally  be  the  initial 
addresss  of  the  user's  program). 

The  Begin  Command  may  also  be  used  to  transfer  to  unconnected  points 
in  the  user's  program.  This  will  be  useful  when  the  user's  program  is  not 
able  to  run  to  completion,  since  several  sections  of  the  program  may  be  reached 
by  the  command. 
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2. 2. 1.2  Correct  Ccmmand 

This  command  allows  the  user  to  enter  octal  correction  and  parameter 
modifications  into  any  location  in  the  computer.  A  maximum  of  eleven  cor¬ 
rections  is  allowed  in  each  Correct  Command. 

2. 2. 1.3  Dump  Command 

This  command  will  cause  an  octal  dump  of  the  computer  memory  between 
the  limits  prescribed  by  the  Dump  Camnand.  The  dxmip  will  be  generated  on  the 
on-line  printer  or  magnetic  tape  according  to  the  user’s  expressed  output 
option  (see  Section  3- !)• 

2. 2. 1.4  End  Command 

This  is  one  of  two  commands  ■vdiich  is  used  to  terminate  command  input 
to  SFCHEX.  SFCHEX  will  continue  to  execute  all  the  commands  vhich  were  entered 
and  the  user's  program  will  be  allowed  to  run  until  it  reaches  its  final  stop 
(or  some  error  stop). 

2.2.1. 5  Header  Command 

This  command  is  used  to  generate  BCD  annotation.  Up  to  seventy-six 
characters  may  be  input  per  command.  These  characters  will  then  appear  on  the 
printer  or  magnetic  tape  according  to  the  output  option  selected  at  the  be¬ 
ginning  of  the  nui. 

2. 2. 1.6  Locate  Command 

This  command  is  necessary  if  the  user  intends  to  enter  any  Trap 
(2.2.1.10)  or  Snap  (2. 2.1. 9)  commands.  The  Locate  command  contains  the  initial 
address  of  a  nine  cell  sequence  in  the  user's  relative  bank,  in  which  SFCHEX 
may  store  a  subroutine.  This  subroutine  (RECOV)  will  be  the  communications 
link  between  the  user's  program  and  SFCHEX,  that  is,  each  time  SFCHEX  sets  a 
jumpout  in  the  user's  program,  the  Jump  will  be  to  RECOV.  RECOV  will  save  the 
A-Register  euid  the  return  address  before  treuisferring  to  SFCHEX  in  another  bank. 
NOTE:  The  Locate  Command  must  be  entered  prior  to  any  Snap,  Trap 
or  Unsnap  commands. 
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2. 2. 1.7  Page  Command 

This  command  will  cause  a  page  eject  in  the  output  listing. 

2. 2. 1.8  Run  Command 

This  command  is  used  to  indicate  to  SFCHEX  that  no  more  commands 
will  be  entered  at  this  time.  This  will  cause  SFCHEX  to  process  the  current 
commands  until  one  of  the  Trap  commands  terminates.  At  this  time  SFCHEX  will 
return  for  more  input  commands. 

2. 2. 1.9  Snap  Command 

The  Snap  command  is  actually  a  specialized  Dunqp  command,  which  is 
executed  each  time  the  computer  encounters  a  prescribed  cell  in  the  user's 
program.  This  specialized  dump  will  consist  of  the  bank  control  settings, 
the  contents  of  the  A-Register,  the  contents  of  the  Buffer  Entrance  Register, 
and  the  first  770  cells  of  a  prescribed  bank  (or  all  four  banks).  The  Snap 
command  will  remain  in  effect  until  a  corresponding  Unsnap  command  (2.2.1.11) 
is  entered  and  executed. 

2.2.1.10  Trap  Command 

The  Trap  command  performs  three  functions. 

a.  Iterate  Dump,  Heading,  Correct,  Mnemonic,  and  Page  coiamands. 

b.  Delay  the  execution  of  Correct,  Dump,  Heading,  Page,  Mnemonic, 
Snap,  and  Unsnap  commands  until  some  strategic  location  is 
reached  in  the  user's  program. 

c.  Return  for  more  command  input  at  appropriate  times. 

The  Trap  command  is  set  up  in  the  following  manner: 

The  Trap  command  contains  an  address  in  the  user's  program  which, when 
encountered,  will  cause  a  transfer  to  SFCHEX.  The  Trap  command  also  contains  a 
parameter  N,  which  indicates  the  number  of  times  this  treuisfer  is  to  occur. 

(if  N  is  input  as  a  zero  the  transfer  will  occur  for  the  remainder  of  the  pro¬ 
gram  run.)  When  the  transfer  occurs  for  the  Nth  time,  the  commands  associated 
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with  the  Trap  command  are  executed  for  the  last  time  and  SFCHEX  returns  for 
more  input.  Note  that  if  N  were  input  as  a  1,  the  user  could  input  more 
commands  (e.g.,  parameter  modifications  by  Correct  command)  as  soon  as  the 
location  included  in  the  Trap  command  is  reached. 

When  a  Trap  command  is  entered,  all  the  subsequent  commands  are 
associated  with  that  command  until  a  Begin,  End,  Locate,  Run,  Wrapup  or  another 
Trap  command  is  entered.  This  "association"  is  effected  by  storing  the  in¬ 
dividual  command  parameters  in  a  Trap  Table.  Snap  and  Unsnap  commands  in  a 
Trap  Table  are  treated  differently  than  the  other  commands.  The  other  commands 
are  executed  each  time  the  Trap  address  is  encountered.  Whereas  the  first 
time  that  a  Trap  Table  is  executed,  any  Snap  or  Unsnap  command  will  be  set  up, 
at  the  proper  address  in  the  user's  program  and  then  the  command  parameters 
will  be  obliterated  in  the  table. 

The  length  of  a  Trap  Table  is  limited  to  forty-eight  cells.  The 
number  of  cells  required  for  each  allowable  command  is  shown  in  the  following 
list. 


Command 

Correct 

Dump 

Heading 

Page 

Snap 

Unsnap 

Mnemonic 


Number 

4  +  N 

5 

2  +  n/2 
1 

4 

5 
5 


Explanation 

N  is  the  number  of  cells  to  be 
corrected.  1  >  N  11 

N  is  the  number  of  BCD  characters 


The  Trap  Table  is  said  to  have  been  "flushed"  when  the  table  has  been 
executed  for  the  Nth  time.  At  this  time,  SFCHEX  will  perform  a  test  to  see  if 
an  End  or  Wrapup  command  has  been  entered.  If  neither  has  been  entered,  SFCHEX 
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will  return  for  more  commands.  Otherwise  the  End  command  (2. 2. 2. 4)  procedure 
or  the  Wrapup  command  (2.2.2.12)  procedure  will  be  followed. 

2.2.1.11  Unsnap  Command 

The  Unsnap  command  is  used  to  remove  a  Snap  command  which  is  current¬ 
ly  in  operation.  When  the  address,  included  in  the  Unsnap  command,  is  en¬ 
countered  in  the  user's  program,  the  associated  Snap  command  will  be  removed. 

The  address  on  the  Unsnap  command  could  be  the  same  as  the  Snap 
command  address.  When  the  user's  program  encounters  that  address,  the  Snap 
command  will  be  deleted.  No  Snap  dun^)  will  be  generated  at  this  time. 

2.2.1'.12  Wrapup  Command 

This  is.  a  counterpart  of  the  End  command.  It  also  indicates  to 
SFCHEX  that  no  more  commands  will  be  entered.  However,  in  this  case,  when 
both  the  Trap  Tables  are  flushed  (except  those  which  £U*e  indefinite,  i.e., 

N  input  as  O),  SFCHEX  will  terminate  the  ram  by  halting,  (if  a  monitor  system 
is  installed  in  the  computer  system,  SFCHEX  can  be  modified  to  return  control 
to  the  monitor  at  this  time . ) 

2.2.1.13  Mnemonic  Dump  Command 

This  command  will  cause  60  word  blocks  of  core  to  be  printed  on  the 
166  printer.  No  conversion  of  data  is  done.  No  headers  or  address  will  be 
printed . 


2.3  Command  Formats 

Figure  2.1  contains  a  column  by  column  illustration  of  each  of  the 
command  formats.  The  formats  are  identical  for  both  card  and  typewriter  in¬ 
put.  SFCHEX  allows  recovery  from  any  error  resulting  from  command  inputs  in 
either  input  mode. 

The  following  section  is  a  description  of  the  commands  in  relation 
to  the  formats  presented  in  Figure  2.1.  Notice  that  every  command  begins 
in  column  1  and  every  command  is  terminated  with  a  period. 
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2.3-1  Coimaand  Formats 


2. 3.1.1 

Begin  Command 

FORMAT: 

B  bXXXX. 

EVENT: 

SFCHEX  terminates  the  current  input  sequence  and  traii6- 

fers  program  control  to  location  XXXX  in  bank  b. 

Important:  This  command  must  be  used  to  terminate  the 

initial  input  consnand  sequence. 

2. 3-1. 2 

Correct 

Command 

FORMAT: 

EVENT: 

C  bXXXX  C^C^C^C^  '^2°2^2^2 

C^C^C^C^  is  stored  in  location  XXXX,  bank  b. 

C  C  C^C  is  stored  in  location  XXXX  +  1,  bank  b. 
2  2  2  2 


« 

c  C  C  C  is  stored  in  location  XXXX  +  (n-l),  bank  b. 
n  n  n  n 

(where  1  <  n  <  11) 


1 
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Figure  2.1  CCMftI®  FORMATS 
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2. 3. 1.3  Dump  Command 

FORMAT:  D  b^XXXX  b^YYYY- 

EVENT:  An  octal  diomp  from  location  XXXX  bank  b^  through  location 

YYYY  bank  bg  will  be  generated  on  the  on-line  printer  or 
read  out  on  magnetic  tape  according  to  the  user's  option. 


2.3.1.^  End  Command 

FORMAT:  E. 

EVENT:  A  switch  is  set  so  that  SFCHEX  will  not  attempt  to  read 

any  more  commands.  Thus  when  all  the  prior  commands  have 
been  completely  executed  the  user's  program  will  be  allowed 
to  continue  until  it  terminates  itself.  ,  After  setting  the 
above  switch  SFCHEX  returns  program  control  to  the  proper 
location  in  the  user's  program. 

2. 3.1. 5  Header  Command 

FORMAT:  H  BCD  COJfffiNT  OP  UP  TO  T6  CHARACTERS. 

EVENT:  The  BCD  command  is  generated  on  the  on-line,  printer  or 

magnetic  tape  depending  on  the  user’s  option.  The  period 
may  not  be  used  as  a  part  of  the  comment.  If  a  period  is 
inadvertently  inserted  in  a  comment,  only  those  char¬ 
acters  prior  to  that  period  will  appear  in  the  output. 

2.3.1. 6  Locate  Commcuid 

FORMAT:  L  bXXXX. 

EVENT:  The  nine  cell  RECOV  Subroutine  will  be  transferred  from 

SFCHEX  to  locations  XXXX  throu^  XXXX  +  8  in  bank  b  (the 
bank  in  which  the  user's  program  is  stored). 

Important;  This  command  must  be  entered  prior  to  any 
Trap,  Snap  or  Unsnap  command. 
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2. 3.1. 7 

Page  Command 

FORMAT: 

P. 

EVENT: 

A  page  will  be  ejected  on  the  on-line  printer  or  on  the 
magnetic  tape  listing  according  to  the  user's  option. 

2. 3. 1.8 

Run  Command 

FORMAT: 

R. 

EVENT: 

SFCHEX  will  stop  accepting  input,  terminate  any  Trap 

Tables  that  are  being  constructed  and  retium  to  the  user 

program  froa  which  it  last  exited. 

2. 3. 1.9 

Snap  Command 

FORMAT: 

S  bXXXX  B. 

EVENT: 

SFCHEX  will  place  a  JPR  RECOV  in  locations  XXXX  throu^ 

XXXX  +  1  in  bank  b#  Whenever  the  computer  encounters  cell 
XXXX  in  bank  b  control  will  be  transferred  to  SFCHEX  and 
a  dump  of  cells  0-JJg  in  bank  B  along  with  the  contents 
of  the  A  Register  will  be  made.  Buffer  Entrance  Register 
and  the  bank  settings  rill  be  output  on  the  proper  mediiam. 
If  B  was  input  as  "4"  a  Snap  duuq)  of  all  four  banks  will 
occur. 


2. 3-1 -10  Trap  Command 

FORMAT:  T  bXXXX  nnnn. 

EVENT:  SFCHEX  will  place  a  JPR  RECOV  in  locations  XXXX  and  XXXX 

+  1  in  bank  b.  One  of  the  two  TRAP  TABLES  will  be  selected 
and  nnnn  will  be  stored  in  the  first  cell  of  that  table. 
Each  time  the  computer  encounters  location  XXXX  in  bank  b 
the  command  parameters  in  the  TRAP  TABLE  will  be  executed 
and  nnnn  will  be  decreased  by  1.  When  nn  is  decreased  to 
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zero  the  Trap  cconnand  is  removed  and  SFCHEX  will  accept  in¬ 
put  if  any  is  forthcoming,  (if  nnnn  was  input  as  "0", 
a  -1  is  stored  in  the  first  cell  of  the  TRAP  TABTH  and 
the  Trap  command  is  never  removed. ) 

Subsequent  commands  are  stored  in  the  TRAP  TABLE  in  the  following 
manner.  (Let  TRAPSTOR  be  the  next  available  location  in  the  TRAP  TABLE). 

a.  Correct  Command  in  a  TRAP  TABU! 

Command  Format:  C  bXXXX  ^2^2^2^2 . 

Command  Storage:  The  address  of  the  CORRECT  Subroutine  is  stored 
in  TRPSTOR.  b  is  stored  in  TRPSTOR  +  1.  XXXX 
is  stored  in  TRPSTOR  +  2.  The  number  of  cor¬ 
rections  included  in  this  command  (i.e.,  n)  is 
stored  in  TRPSTOR  +  3- 

^l^l^l^l  stored  in  TRPSTOR  +  4. 

CgCgCgCg  is  stored  in  TRPSTOR  +  5- 

C  C  C  C  is  stored  in  TRPSTOR  +  (n  +  3) 

b.  Dunq>  Command  in  a  TRAP  TABU! 

Command  Format:  D  b^XXXX  bgYYYY. 

Command  Storage:  The  address  of  the  DUMP  Subroutine  is  stored 

in  TRPSTOR.  b^  is  stored  in  TRPSTOR  +  1.  XXXX 
is  stored  in  TRPSTOR  +2.  bg  is  stored  in 
TRPSTOR  +  3-  TCn  is  stored  in  TRPSTOR  +  4. 
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c.  Header  Command  in 
Command  Format: 
Command  Storage: 


d.  Page  Command  in  a 
Command  Format: 
Command  Storage: 

e.  Snap  Command  in  a 
Command  Format: 
Command  Storage: 

f.  Unsnap  Command  in 
Command  Format: 
Command  Storage: 


a  TRAP  TABIE 

«  V2 . »n- 

The  address  of  the  HEAD  Subroutine  is  stored 

in  TRPSTOR.  Half  the  number  of  BCD  characters 

(i.e.,  n/2)  are  stored  in  TRPSTOR  +  1.  H^Hg 

is  stored  in  TRPSTOR  +  2.  is  stored  in 

TRPSTOR  +  3.  •  •  •  H  ,H  is  stored  in 

n-1 '  n 

TRPSTOR  +  (2  +  n/2). 

TRAP  TABLE 
P. 

The  address  of  the  PAGE  Subroutine  is  stored 
in  TRPSTOR. 

TRAP  TABLE 
S  bXXXX  B. 

The  address  of  the  Snap  SETUP  Subroutine  is 
stored  in  TRPSTOR.  b  is  stored  in  TRPSTOR  +  1. 
XXXX  is  stored  in  TRPSTOR  +2.  B  is  stored  in 
TRPSTOR  +  3- 

a  TRAP  TABLE 
U  b^Xm  b^YYYY. 

The  address  of  the  Unsnap  SETUP  Subroutine  is 
stored  in  TRPSTOR.  b^  is  stored  in  TRPSTOR  +  1. 
XXXX  is  stored  in  TRPSTOR  +2.  b^  is  stored 
in  TRPSTOR  +  3.  YYYY  is  stored  in  TRPSTOR  +  4. 


I 
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g.  Mnemonic  canmand  In  a  TRAP  TABLE 
Command  Format:  N  bXXXX  ONMllN 

Command  Storage:  The  address  of  the  mnemonic  Subroutine  Is 

stored  in  TRPSTOR.  b  is  stored  in  TRPSTOR  +  1. 
X30CX  is  stored  in  TRPSTOR  +2.  0  is  stored  in 

TRPSTOR  +  3-  NUNN  is  stored  in  TRPSTOR  +  U. 


h.  Begin,  Run,  End,  Wrapup  or  a  second  Trap  command  will  indicate 
to  SFCHEX  that  the  current  TRAP  TABI£  is  complete.  In  this  case 
7777  will  be  placed  in  TRPSTOR.  The  7777  will  serve  as  a  flag 
to  terminate  the  execution  of  the  command  parameters  in  the 
TRAP  TABLE. 


2.3-1-11  Unsnap  Commauid 

FORMAT:  U 

EVENT:  SFCHEX  will  place  a  JPR  RECOV  in  locations  XXXX  and 

XXXX  +  1  in  bank  b^.  When  the  computer  encounters 
location  XXXX  control  will  be  transferred  to  SFCHEX. 

At  this  time  the  Snap  command  jump  (i.e.,  JPR  RECOV) 
will  be  removed  from  location  YYYY  and  YYYy+  1  in  beink 
bg.  At  the  same  time  the  Unsnap  command  jump  will  be 
removed  from  locations  XXXX  and  XXXX  +1.  Then  control 
will  be  returned  to  the  user's  program  at  location 
b^XXXX. 

2.3.1.12  Wrapup  Command 
FORMAT:  W. 

EVENT:  A  switch  is  set' so  that  SFCHEX  will  not  attempt  to  read 

in  any  more  ccmmands.  Then  the  TRAP  TABIES  are  checked. 
If  both  tables  are  empty  (indefinite  traps  count  as  being 
empty  in  this  regard)  SFCHEX  will  teminate  the  program. 
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Otherwise  SFCHEX  returns  control  to  the  proper  location 
in  the  user's  program.  However,  •vrtien  all  the  finite 
(i.e.,  not  indefinite)  traps  have  been  flushed,  SFCHEX 
will  termiimte  the  program. 

Command 

N  bXXXX  ONNHN 

A  dump  of  core  from  location  XXXX  in  bank  b  in  groups 
of  60  word  blocks  specified  by  HHHN  will  be  printed  on 
the  166  line  printer »  No  conversion  of  data  is  done. 

No  headers  or  address  will  be  printed. 
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3.0  OUTPUT 

3.1  Output  Modes 

SFCHEX  allows  two  modes  of  output;  the  166  on-line  printer  or  a  163 
magnetic  tape  unit.  SFCHEX  will  request  the  output  option  hy  printing  on  the 
typewriter: 

MODE  OUT 

The  user  will  then  indicate  his  option  by  typing  a  "P"  for  166  on¬ 
line  printer  output  or  a  "Mx"  (x  being  a  tape  handler  number)  for  magnetic 
tape  output. 

Since  selecting  either  BCD  or  Binary  mode  causes  both  tape  handlers 
on  the  same  unit  to  be  set  in  that  mode,  SFCHEX  will  restore  the  tape  unit 
to  its  original  mode  before  returning  control  to  the  user's  program.  This 
allows  the  user  to  output  in  a  binary  format  on  the  same  unit  which  SFCHEX 
uses  for  BCD  formats,  without  having  to  reset  the  modes. 

3.2  Output  Formats 

The  only  normal  output  from  SFCHEX  are  BCD  annotations  and  octal 
dumps.  (The  Snap  Command  merely  defines  special  limits  for  a  dump.)  A  heading 
will  precede  the  dump.  This  heading  will  contain  the  B,  D,  I  and  R  Bank 
settings,  the  last  address  (p)  encountered  in  the  user's  program,  the  contents 
of  the  A-Register  at  the  time  address  (p)  was  encountered  and  the  contents 
of  the  Buffer  Entrance  Register  at  that  time. 

3.2.1  Dump  Format 

The  Dump  command  defines  a  lower  limit  address  (LL)  and  an  upper 
limit  address  (UL),  between  which  the  octal  dump  is  to  be  generated.  For  the 
sake  of  uniformity,  SFCHEX  reduces  LL  to  the  nearest  multiple  of  16^q-  Simi¬ 
larly,  UL  is  increased  to  the  nearest  multiple  of  16^q-  This  allows  the  output 
of  an  integral  set  of  (16  cell)  lines  with  the  initial  address  of  the  cell  at 
the  beginning  of  each  line  an  integral  multiple  of  200. 
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For  additional  ease  in  reading,  the  i6^q  octal  cells  listed  on  each 
line  are  gathered  into  four  groups,  with  the  separation  between  words  within 
a  group  being  less  than  the  separation  between  two  groups.  Figure  3-1  is  a 
sample  of  the  dump  format. 

3.3  Error  Messages  and  Recovery  Procedures 

SFCHEX  will  generate  comments  on  the  on-line  typewriter  in  the 
event  of  certain  malfunctions  due  to  erroneous  command  input  procedures. 

3.3- 1  Illegal  Input  Character 

If  SFCHEX  encounters  an  illegal  character  in  the  interpretation  of 
a  command,  three  question  marks  (?  ?  ?)  will  appear  on  the  on-line  typewriter. 

Recovery  Procedure 

Typewriter  input  mode:  SFCHEX  will  cause  a  carriage  return  and  type 
an  *.  The  user  may  retype  the  entire  command. 

Card  input  mode:  The  card  should  be  repunched  and  the  user  may  re¬ 
start  the  program  with  that  card  by  setting  SLJ2  and  starting  at  location  233^ 
in  the  bank  in  which  SFCHEX  is  stored. 

3.3- 2  Illegal  Instruction 

Some  instructions  in  the  16OA  repertoire  sure  not  allowed  as  cells 
in  which  a  Snap  or  Trap  junQ)  can  be  replaced,  since  SFCHEX  is  unable  to  trans¬ 
late  those  Instructions.  (See  Restrictions  U.l).  When  SFCHEX  encountera  such 
eui  Illegal  instruction,  the  following  comment  will  be  generated  on  the  type¬ 
writer. 

IL  INST  AT  BXXXX 

B  will  be  the  bank  and  XXXX  the  location  in  which  the  non-trsmslatable  in¬ 
struction  was  stored. 

Recovery  Procedure 

Typewriter  input  mode:  SFCHEX  will  remove  the  Trap  or  Snap  Command 
and  then  cause  a  carriage  return  and  type  an  asterisk.  The  user  may  then  re¬ 
enter  the  Trap  or  Snap  command  at  a  different  eiddress  or  type  in  some  other 
command. 
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Figure  3 • 1  Sample 
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Card  input  mode:  SFCHEX  will  remove  the  Trap  or  Snap  Command  and 
stop.  The  user  should  correct  or  remove  the  erroneous  command  card.  The  user 
may  restart  the  program  with  the  corrected  card  by  setting  SLJ  2  and  starting 
at  location  2200  in  SFCHEX 's  bank. 

3.3-3  Illegal  Input  Command 

If  a  spurious  command  is  input  to  SFCHEX,  the  following  message  will 
be  generated  on  the  typewriter. 

IL  COM 

Recovery  Procedure 

Typewriter  input  mode:  SFCHEX  will  cause  a  carriage  return  and  type 
an  asterisk.  The  user  may  retype  the  command. 

Card  input  mode:  The  erroneous • card  should  be  repunched  and  the  user 
may  restart  the  program  with  that  card  by  setting  SLJ  2  and  starting  at  lo¬ 
cation  2200  in  SFCHEX' s  bank. 

3-3-^  Three  Simultaneous  Traps,  Snaps,  or  Unsnaps 

If  the  user's  input  command  sequence  should  be  so  set  up  as  to 
result  in  an  attempt  to  set  up  a  third  Trap,  Snap,  or  Unsnap  command,  the 
following  message  will  be  generated  on  the  typewriter. 

THIRD  CC»! 

Recovery  Procedure 

Typewriter  input  mode:  SFCHEX  will  remove  the  third  Snap,  Trap 
or  Unsnap  command,  cause  a  carriage  return  suid  type  eui  asterisk.  The  user 
may  then  enter  another  command. 

Card  input  mode:  SFCHEX  will  remove  the  third  Snap,  Trap,  or  Unsnap 
euid  stop.  The  user  should  modify  the  command  sequence.  The  user  may  resteirt 
the  program  at  that  point  by  setting  SLJ  2  and  starting  at  location  220b  in 
SFCHEX' s  bank. 
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3"3‘5  Unsnap  Command  Address  Does  Not  Match  Any  Snap  Command  Address 

If  the  user  should  enter  an  Unsnap  command  in  which  the  address  of 
the  Snap  command  to  be  removed  cannot  be  matched  with  the  address  of  any  Snap 
command  which  is  currently  in  effect,  the  following  message  will  be  generated 
on  the  typewriter. 

NO  S  AT  BXXXX 

Recovery  Procedure 

Typewriter  input  mode:  SFCHEX  will  remove  the  Unsnap  command,  cause 
a  carriage  return  and  type  an  asterisk.  At  this  point  the  correct  Unsnap 
command  may  be  entered  followed  by  a  Run  command  (2. 3- 1.8), 

Card  input  mode:  SFCHEX  will  remove  the  Unsnap  command,  type  out 
the  error  message  and  halt.  To  recover,, the  user  must  punch  on  cards  the  correct 
Unsnap  command  and/or  a  R\m  command  (2.3*l-8),  put  Jump  switch  2  up  and  effect 
a  manual  Jump  from  the  console  to  location  2200  in  the  bank  in  which  SFCHEX 
is  located. 

3.3*6  TRAP  TABLE  Capacity  Exceeded 

If  a  user  exceeds  the  capacity  of  a  TRAP  TABLE  which  is  being  set 
up,  the  following  message,  will  be  generated  on  the  typewriter. 

T  T  OVRFLW 

Important :  SFCHEX  removes  edl  the  commands  which  were  placed  in  the 
TRAP  TABI£  including  the  Trap  command  itself. 

Recovery  Procedure 

Typewriter  input  mode;  SFCHEX  will  remove  the  whole  TRAP  TABLE, 
cause  a  carriage  return  and  type  an  asterisk.  The  user  should  decide  the  manner 
in  which  he  wants  to  reduce  the  length  of  the  TRAP  TABLE  to  less  than  forty- 
ei^t  cells  euid  then  begin  the  input  by  retyping  the  Trap  command. 
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Caxd  input  mode:  SFCHEX  will  remove  the  whole  TRAP  TABLE  euid  then 
stop.  The  user  should  modify  the  TRAP  TABLE  sequence  and  begin  with  the  trap 
command  by  setting  SLJ  2  and  starting  at  location  2200  in  SFCHEX' s  bank. 
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4.0  OPERATING  INSTBUCTIOMS 

4.1  Options 

4.1.1  Input  Option 

The  user  may  input  commands  via  the  typewriter  or  the  on-line  card 
reader.  The  user  signifies  his  choice  by  responding  to  SFCHEX's  question 
"MODE  in"  with  a  "T"  for  typewriter  or  a  "C"  for  on-line  card  reader. 

4.1.2  Output  Option 

The  user  may  choose  between  the  on-line  printer  or  magnetic  tape 
as  his  output  medium.  The  user  signifies  his  choice  by  responding  to  SFCHEX's 
question  "MODE  OUT"  with  a  "P"  for  on-line  printer  or  a  "Mx"  (x  =  a  tape  handler 
number)  for  magnetic  tape  output. 

4-1-3  SLJ  Switch  Options 

If  SFCHEX  has  been  used  prior  to  the  current  situation,  the  present 
user  may  use  the  same  input-output  media  as  the  previous  user  by  setting  SLJ  1 
and  starting  the  program.  This  will  result  in  SFCHEX  skipping  the  "MODE  IN", 
"MODE  OUT"  questions. 

SLJ  2  causes  SFCHEX  to  bypass  initialization  of  the  trap  tables. 

4.2  SFCHEX  Operation 

SFCHEX  will  normally  be  loaded  in  the  upper  half  of  bank  2,  starting 
at  location  2200. 

a.  Load  the  user's  program  in  any  beuik. 

b.  If  the  input  mode  is  to  be  by  card,  the  command  cards  should  be 
placed  in  the  card  reader. 

c.  Start  at  location  2200  in  bank  2. 

d.  Respond  to  "MODE  IN",  by  typing  a  "T"  or  "C"  on  the  typewriter. 

e.  Respond  to  "MODE  OUT"  by  typing  a  "P"  or  "Mx"  (x  =  the  tape 
handler  number). 
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6.  SFCHEX  will  now  begin  to  enter  commands. 

a.  If  the  input  mode  is  by  csu*d,  SFCHEX  will  read  the  cards 
it  needs  them. 

b.  If  the  input  mode  is  by  typewriter,  SFCHEX  will  sigjml  the 
user  with  a  carriage  return  and  an  *  each  time  it  is  pre¬ 
pared  to  accept  a  command. 

4.3  Operating  Restrictions  and  Limitations 

4.3.1  Illegal  Instructions 

In  the  setting  up  of  a  Snap,  Trap,  or  Unsnap  comnand,  SFCHEX  places 
a  JPR  to  the  RECOV  Subroutine  in  the  indicated  address  in  the  user's  program. 

It  is  a  restriction  that  the  two  cells  in  which  the  JPR  instruction  is  placed 
must  not  be  modified  in  any  manner.  Any  instructiai  whose  E,  F,  or  G  field  is 
modified  in  any  manner  may  not  be  selected  by  the  user  for  a  Trap,  Snap  or 
Unsnap  command.  This  includes  the  following  situation. 

A1  STR  TRl 

A2  LDC 

A3  1111 

Suppose  the  user  input  a  Snap  command  to  be  set  up  at  Al,  and  suppose 
the  contents  of  A3  are  modified  by  another  portion  of  the  program,  SFCHEX  would 
translate  the  instruction  at  Al  and  in  the  translation  of  the  instruction  at  A2, 
SFCHEX  would  pick  up  the  contents  of  A3  and  save  it  in  bank  2.  Thus  althou^ 
modification  of  the  contents  of  A3  would  not  affect  the  JPR  command  in  Al  and 
A2,  the  change  in  A3  would  go  unnoticed. 

Similarly,  the  second  cell  in  which  the  JPR  to  RECOV  seq_uence  is 
stored  must  not  be  the  object  of  some  transfer  instruction.  The  reason  for  this 
is  obvious.  When  the  Jump  is  effected,  the  user's  program  will  execute  the  G 
field  of  the  JPR  instruction. 


\ 
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4.3.2  Non-Translatable  Instructions 

The  following  Instructions  are  not  allowed  to  occur  in  the  cells 
selected  by  the  user  for  a  Trap  or  Snap  command. 

(Note :  These  are  allright  for  Snap  cammands . ) 


1. 

ERR 

Error  stop 

2. 

HLT 

Halt 

3. 

JPR 

Return  jump 

4. 

SI£ 

Selective  stop 

5. 

SJS 

Selective  stop  and  jump 

ALL  INPUT-OUTPUT  INSTRUCTIONS. 


The  reason  that  these  instructions  not  allowed  is  that  SFCHEX 
has  no  translation  for  them.  Inclusion  of  one  of  the  above  commands  will 
cause  SFCHEX  to  print  out; 

IL  INST  AT  BXXXX  (See  3.3-2) 


4.3.3  The  Locate  Command 

The  Locate  Command  must  be  entered  prior  to  any  Trap,  Snap  or  Unsnap 
command.  This  is  due  to  the  fact  that  the  latter  three  commands  assume  that 
a  communication  link  with  the  user's  program  has  already  been  established. 

4.3.4  The  Begin  Command 

The  Begin  command  must  be  used  to  terminate  the  initial  set  of  input 
commands.  This  is  due  to  the  fact  that  SFCHEX  does  not  have  any  address  (at 
this  time)  in  the  user's  program  to  which  it  csui  transfer  program  control. 

4.3.5  TRAP  TABLE  Limit 

The  parameters  associated  with  a  Trap  command  must  not  exceed  forty- 
eight  cells  of  the  corresponding  TRAP  TABLE.  If  too  many  comnands  are  entered 
into  the  TRAP  TABLE,  SFCHEX  will  print -out. 


) 


TT  OVRFLW  (see  3-3-6) 
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The  following  la  a  list  of  the  cells  required  for  each  type  of 
command  which  can  be  placed  in  a  TRAP  TABLE. 


Snap 

Unsnap 

Correct 

Heade  r 

Dump 

Page 

Mnemonic 


4  cells 

5  cells 

(4  +  n)  cells  (n  is  the  number  of  corrections) 

(2  +  n/2)  cells  (n  is  the  number  of  BCD  characters) 
5  cells 
1  cell 
5  cells 


4.3.6  Input -Output 

If  the  input  media  (i.e.,  the  typewriter  or  card  reader)  is  not 
ready,  SFCHEX  will  wait  until  the  equipment  is  ready.  No  comment  will  be 
generated. 


Likewise,  if  the  output  media  is  not  ready,  SFCHEX  will  wait  and 
no  comment  will  be  generated. 


The  user  will  be  able  to  observe  either  of  the  above  conditions, 
since  no  commands  are  accepted  by  SFCHEX  until  both  the  input  and  output 
mediums  have  been  tested. 


4.3.7  Trap,  Snap  and  Unsnap  Commands 

No  more  than  2  each  of  the  Snap,  Trap  or  Unsnap  commands  can  be 
active  at  the  same  time.  By  active,  we  mean  that  a  JPR  RECOV  has  been  placed 
in  the  user's  program.  You  could  have  a  third  Snap  or  Unsnap  command  in  a 
TRAP  TABI£  which  has  not  been  set  up.  But  vhen  the  Snap  or  Unsnap  command 
did  get  set  up,  one  of  the  other  Snap  or  Unsnap  commands  will  have  had  to  be 
removed.  A  third  active  command  will  result  in  the  error  message: 

THIRD  COM.  (See  3-3.4) 
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4.3.8  Pressing  the  Load  Button  On  the  l67-2  On-Line  Card  Reader 

In  validationj  it  vas  observed  that  the  depression  of  the  load  button 
on  the  167-2  on-line  card  reader  resulted  in  an  over-ride  of  the  typewriter 
input  option  selection.  The  indication  of  such  a  mistake  will  be  an  error 
printout  loop  of  the  following  message 

IL  INST  AT  2020 

4.3.9  Eq.uipment  Configuration 

SFCHEX  is  a  diagnostic  program  with  storage  requirements  of  285O 
cells.  It  is  bank  independent  with  the  exception  of  storage  in  bank  3-  For 
full  capability,  the  equipment  configtuation  must  consist  of  a  I6OA/169  com¬ 
puter,  a  161  typewriter,  a  167-2  on-line  card  reader,  a  166  on-line  printer 
and  a  163  tape  unit. 

The  timing  requirements  for  the  operation  of  SFCHEX  is  a  function 
of  the  amount  of  input  commands. 
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5.0  SFCHEX  Capability 

5.1  The  Trap  CoTrnnAnd 

The  Trap  command  format  and  operation  is  described  in  detail  in 
Section  2.  When  a  Trap  command  is  entered,  a  flagged  jump  is  placed  in  the 
user's  program  so  that  when  that  jump  is  encountered,  control  is  transferred 
to  SFCHEX  via  the  RECOV  Subroutine.  At  this  time  the  Trap  Table  associated 
with  the  flagged  jump  is  executed;  that  is,  each  command  which  was  input  in 
connection  with  the  Trap  command  will  either  be  set  up  or  executed.  Any  Snap 
or  Unsnap  commands  are  set  up  by  placing  a  flagged  jump  in  the  user's  program 
at  the  indicated  address.  Correct  commands  are  executed  by  storing  the  para¬ 
meters  in  the  proper  locations.  The  Snap,  Unsnap  and  Correct  commands  are  then 
deleted  from  the  Trap  Table  so  that  subsequent  executions  of  the  Trap  Table 
will  not  result  in  redundant  and  perhaps  disastrous  reexecutions  of  the  above 
commands.  Dump,  Header  and  Page  commands  will  be  executed  each  time  the  Trap 
Table  is  executed. 

The  key  feature  of  the  Trap  command  is  the  parameter  n  (the  number  of 
times  the  Trap  Table  is  to  be  executed).  If  n  is  entered  on  the  Trap  commeuid 
as  0,  the  associated  Trap  Table  will  continue  to  be  executed  each  time  the 
flagged  jump  is  encountered.  This  will  continue  for  the  duration  of  the  pro¬ 
gram.  If  n  is  input  with  a  positive  value,  the  Trap  Table  will  be  executed  up 
to  n  times  at  which  time  the  Trap  Table  will  be  "flushed".  "Flushing"  consists 
of  the  removing  of  the  flagged  jump  in  the  user's  program,  replacing  the  in¬ 
structions  at  that  location  and  terminating  the  Trap  Table,  (if  n  is  not  given 
the  Table  shall  be  executed  only  once . ) 

At  this  time  SFCHEX  will  be  ready  to  accept  more  commands.  The  user 
may  decline  to  enter  more  commands  at  this  time  by  using  the  Run  command,  or  he 
may  decline  to  enter  any  more  commands  for  the  duration  of  the  run  by  using  eui 
End  or  Wrapup  command.  Otherwise  the  user  may  enter  any-  sequence  of  commands 
which  is  compatible  with  the  restrictions  and  limitations  listed  in  Section  4. 
However,  if  the  user  desires  to  communicate  with  SFCHEX  at  some  later  time,  he 
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must  ma}ce  sure  that  a  Trap  Table  will  flush  at  that  time.  The  Trap  command 
can  be  used  strictly  for  communication  purposes,  that  is,  it  is  not  necessary 
to  associate  any  commands  with  it  (the  Trap  Table  may  be  empty).  Thus,  each 
time  the  corresponding  flagged  jump  is  encountered  in  the  user's  program,  n 
will  be  decreased  by  one.  When  n  is  reduced  to  zero,  the  user  will  be  allowed 
to  enter  more  commands. 

5.2  SFCHEX  Strategy 

The  following  paragraphs  contain  examples  of  debugging  situations 
for  \rtiich  SFCHEX  is  ideally  suited,  and  advice  for  judicious  use  of  the  commands. 

5.2.1  With  two  Trap  Tables  available, it  would  be  unwise  to  set  up  an  in¬ 
finite  trap  (n  input  as  O),  unless  the  user  has  only  minimal  debugging  pro¬ 
cedures  planned  for  the  run.  Once  an  infinite  Trap  Table  is  set  up,  it  cannot 
be  removed  until  SFCHEX  is  restarted. 

5.2.2  Consider  a  program  which  consists  of  several  modules  and  which  is  not 

sufficiently  checked  out  for  a  continuous  run  through  the  modules.  Normally, 
the  user  program  has  to  check  out  the  modules  one  by  one  by  separating  the 
program  and  writing  small  drivers  for  the  modules  or  by  attending  the  computer 
runs  and  manually  transferring  from  one  module  to  the  next.  With  SFCHEX,  the 
user  could  set  up  a  continuous  run  by  discrete  use  of  Trap,  Correct,  Dump  and 
Begin  commands.  For  example,  set  a  Trap  command  at  the  end  of  the  first  module 

with  n  equal  to  one.  Use  the  Begin  command  to  start  at  the  proper  location  in 

the  first  module.  When  the  program  encounters  the  Trap  Flag,  the  user  could 
execute  a  Dump  of  the  first  module,  use  the  Correct  command  to  set  up  ideal 

parameters  for  the  next  module,  enter  a  Trap  Command  at  the  end  of  the  next 

module  and  then  use  the  Begin  command  to  start  at  the  proper  location  of  the 
next  module.  This  process  can  continue  for  each  module  until  the  run  is  com¬ 
pleted. 


5*2.3  Remember  that  the  only  commands  which  terminate  a  Trap  Table  are  the 
Run,  Begin,  End,  Wrapup  or  another  Trap  command.  Therefore,  in  an  input  period. 
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if  any  Header,  Page,  Snap,  Unsnap,  Dump,  or  Correct  conumnds  to  be  exe¬ 
cuted  immediately,  they  must  be  input  prior  to  any  Trap  Commands,  since  the 
commands  which  terminate  the  Trap  Table  also  cause  SFCHEX  to  transfer  control 
to  the  user's  program. 

5.2.4  When  a  programmer  desires  to  test  the  effect  of  several  different 
values  of  some  parameter,  he  could  run  a  parameter  study  using  Trap,  Begin 
and  Correct  commands.  The  procedure  would  be  to  set  a  Trap  command  at  the 
end  of  the  program  with  n  equal  to  1  and  use  the  Begin  command  to  start  the 
program.  When  the  first  run  is  complete,  the  Trap  will  allow  the  programmer 
to  use  the  Correct  command  to  enter  a  new  value  for  the  parameter,  enter  a  new 
Trap  Comman(5L  with  n  equal  to  one  and  use  the  Begin  command  to  restart  the 
program. 
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6.0  TEST  CASES 

6.1  Procedures 

In  checking  out  SFCHEX  the  programmer  followed  the  normal  procedures 
for  checking  out  the  individual  sections  and  modules  for  logical  and  diagnostic 
errors.  Each  of  the  input  commands  was  individually  checked  to  see  if  it 
functioned  correctly.  Several  different  computer  instruction  translations 
were  run  off  by  the  SETUP  Subi’outine  and  checked  against  hand  written  results. 
As  soon  as  SFCHEX  began  to  run  in  normal  fashion  it  was  turned  upon  itself. 

That  is,  SFCHEX  corrected,  snapped,  trapped,  and  dumped  itself. 


The  validation  specifications  were  essentially  SFCHEX'  only  really 
complete  test.  The  following  pages  of  this  section  will  deal  with  the  vali¬ 
dation  specifications  appearing  in  the  Milestone  VI  Document. 


6.2  Sample  User's  Program 

A  small  program  was  generated  to  serve  as  a  sample  user's  program 
on  which  SFCHEX  could  operate.  This  program  contains  a  variety  of  instructions 
so  that  each  of  the  nine  instruction  treuislation  modules  in  the  SETUP  Sub¬ 
routine  can  be  exercised.  The  program  was  designed  to  iterate  4  times  and 
then  halt.  Each  iteration  of  the  program  is  divided  into  two  sections.  The 
first  section  fills  a  896  cell  buffer  with  a  series  of  16  0000 's,  16  1111 's, 
16  2222 's,  etc,  until  all  896  cells  are  filled.  The  second  fills  the  same 
buffer  with  7777' s.  The  program  was  coded  in  a  roundabout  manner  so  that  eui 
adequate  cross  section  of  commands  could  be  used.  The  following  pages  contain 
the  symbolic  coding  of  the  sample  user' s  program. 


SAMPLE  PROGRAM 


LOG 

TAG 

OIER 

ADD 

ORG 

100 

100 

SICO 

101 

SDCO 

SETUP 

MODULE 
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SETUP 

LOG 

TAG 

OFER 

ADD 

MODULE 

102 

LDN 

4o 

103 

STM 

TSTI7 

lo4 

105 

TSTl 

LDN 

70 

MODIC 

106 

STD 

TDl 

MODIC 

107 

LDN 

0 

MODIC 

no 

STM 

TST3 

MODIB 

111 

112 

LDC 

TSTBF 

MODID 

113 

ii4 

STD 

TD2 

115 

TST8 

LDN 

20 

116 

STM 

TST4 

117 

120 

TST5 

LIH4 

TST3 

121 

122 

STI 

TD2 

123 

AOD 

TD2 

124 

LI»f 

tst4 

125 

126 

SEN 

1 

MODIC 

127 

STR 

TST4 

t©DlA 

130 

NZR 

TSTI5 

131 

LCN 

1 

132 

RAD 

TDl 

I33 

ZJR 

TST6 

M0D2A 

134 

LI»t 

TST3 

MODIB 

135 

136 

ADC 

nil 

137 

i4o 

STR 

TST3 
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SETUP 

LOG 

TAG 

OPER 

ADD 

MODULE 

i4i 

LDN 

1 

142 

NZR 

TST8 

i43 

tst6 

PTA 

MOD9 

ll4-4 

ARN 

5 

MODIC 

1^4-5 

STD 

TD3 

MODIC 

146 

JPI 

TD3 

M0D2B 

14? 

NOP 

150 

STPO 

M0D8 

151 

LDN 

4 

MODIC 

152 

RAD 

50 

MODIC 

153 

JPI 

50 

MOD2B 

154 

SLJ 

1 

M0D4 

155 

TSI5 

156 

TSTI5 

PTA 

MOD9 

157 

ADN 

3 

MODIC 

160 

SRJO 

MOD5 

161 

LDC 

TSTBF 

162 

163 

TST12 

ATE 

TST12 

M0D7 

l64 

165 

TSTI3 

LDC 

TSTBX 

166 

167 

ATX 

TSTI3 

MOD7 

170 

171 

SBUO 

mod6 

172 

LCN 

1 

MODIC 

173 

TST14 

BLS 

tsti4 

MOD7 

174 

175 

LCN 

1 

MODIC 

176 

RAR 

TST17 

MODIA 

177 

ZJR 

TST18 

M0D2A 
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LOG 


TAG 


SETUP 

OFER  ADD  MODUm 


200 

JFI 

201 

202 

TSTI8 

HLT 

203 

TSTI7 

204 

TST3 

205 

tst4 

CON 

1 

TDl 

2 

TD2 

3 

TD3 

ORG 

300 

TSTBF 

BSS 

2100 

TSTBX 

END 

1  MOD3 

TSTl 

ILLEGAL 


1 


300 
89  6d 


6.3  VeLlldation  Prodecures 

SFCHEX  vas  validated  euid  accepted  on  21  December  I962.  The  vali¬ 


dation  tests  concentrated  on  the  following  main  points. 


i 


f 


a.  The  different  SFCHEX  commands  were  entered  in  various  sequences, 
executed  and  the  resulting  output  corresponded  to  specified 
results . 

b.  Several  different  types  of  16OA  computer  instructions  in  the 
sample  user's  program  were  translated  by  the  SETUP  Subroutine 
in  SFCHEX.  The  continued  accurate  running  of  the  sample  user's 
program  was  taken  as  an  adequate  indication  that  the  instructions 
were  being  translated  correctly. 

c.  Both  the  typewriter  and  card  input  modes  and  both  the  printer 

and  magnetic  tape  output  modes  were  exercised  in  all  four  possible 
input-output  ccmbinations .  Naturally,  not  all  of  the  possible 
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command  sequences  could  be  tried,  but  this  caused  no  problems 
due  to  the  fact  that  the  ccmmand  procedures  are  autonomous 
(except  for  the  Trap  Table  Sequences). 


The  five  following  tests  were  designed  to  validate  the  command 
execution,  the  table  capacities  and  the  diagnostic  stops  in  SFCHEX.  They 
are  reproduced  in  the  same  format  as  presented  in  the  Milestone  VI  Document. 


6.3-1  Test  One 

This  test  will  exercise  all  of  the  translation  modules  in  the 
SETUP  Subroutine,  and  also  all  of  the  command  types. 


6. 3.1.1  CommATid  Card  Sequence 


COM  COL.  4 


INST.  MODE  TRANSLATED 


c 

00107 

0400  4100  0204. 

L 

03000. 

C 

00100 

0020. 

P 

H 

TEST  ONE. 

H 

INITIAL  DUMP. 

D 

00100 

00202. 

T 

00105 

0002. 

MODIB 

S 

00112 

0 

MODID 

H 

TRAP  DUMP. 

D 

00300 

00340. 

B 

00100. 

S 

00146 

0. 

M0D2B 

u 

00107 

00112. 

u 

■  00150 

00046. 

T 

00154 

0002. 

M0D4 

T 

00160 

0002. 

M0D5 

MODIC 


TM-1003/002/00 


12  February  1963 


6-6 


COM 

COL.  U 

S 

00160 

0002. 

R. 

U 

00163 

00150. 

R. 

T 

00171 

0002. 

T 

00200 

0006. 

C 

00004 

1234. 

S 

00163 

0. 

R. 

S 

00176 

0. 

U 

00150 

00163. 

u 

00107 

00176. 

R. 

T 

00143 

0002. 

W. 

INST.  MODE  THANSLAIED 
MOD5 

M0D6 

MOD3 

MOD7 

MODIA  M0D2A 

MOD9 


6.3‘1*2  Procedure 

a.  Read  in  SFCHEX  Program. 

b.  Read  SAMPLE  User's  Program  into  bank  0. 

c.  Place  Command  Cards  in  Card  Reader. 

d.  Start  at  initieJ.  instruction  of  SFCHEX. 

e.  Respond  to  MODE  IN  with  a  C  on  the  typewriter. 

f .  Respond  to  MODE  OUT  with  a  P  on  the  typewriter. 

6. 3.1. 3  Acceptance  Criteria 

a.  Output  will  appear  on  the  on-line  printer. 

b.  Cetrds  will  be  read  in  from  the  on-line  card  reader. 

c.  Output  Seq^uence 
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1. 

"TEST  ONE" 

2. 

"INITIAL  DUMP" 

3- 

Dump  from  00100  to 

4. 

"TRAP  DUMP 

V 

5. 

Dump  from  OO30O  to 

6. 

Dump  0-77  bank  0 

Cell  1 

0070 

Cell  2 

0000 

Cell  3 

0000 

Cell  50 

0000 

7- 

Same  as  d. 

8. 

Dump  from  OO3OO  to 

9. 

Dump  0-77 

bank  0 

Cell  1 

0 

Cell  2 

2100 

Cell  3 

150 

10. 

Same  as  i 

11. 

Dump  0-77 

bank  0 

Cell  1 

0000 

Cell  2 

2100 

Cell  3 

0150 

Cell  4 

1234 

12. 

Same  as  k 

13. 

Program  will  halt 

00202 

00740 

00340  containing  7777 's 


SFCHEX  program. 


6.3.2  Test  Two 

This  test  is  the  same  as  Test  One  with  Step  A  of  the  procedure 
(6. 3. 1.2)  deleted. 

6. 3. 2.1  Command  Card  Sequence 


Same  as  in  6. 3. 1*1 
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6. 3. 2. 2  Procedure 

a.  Read  in  SAMPLE  User's  program. 

b.  Place  Command  Cards  in  Card  Reader. 

c.  Start  at  initial  instruction  of  SFCHEX  with  JS  1  set  if  same 
input/output  modes  (therefore  skip  steps  D  and  E  which  follow). 

d.  Respond  to  MODE  IN  with  a  C  on  the  typewriter. 

e.  Respond  to  MODE  OUT  with  a  P  on  the  typewriter. 

6. 3- 2. 3  Acceptance  Criteria 

The  results  should  be  identical  to  the  criteria  in  6.3.1.3*  This 
will  indicate  that  SFCHEX  can  be  used  by  successive  programs. 

6.3.3  Test  Three 

This  test  is  similar  to  Test  Two  with  Step  A  of  the  procedure  de¬ 
leted  and  input  by  typewriter  rather  than  card. 

6.3.3<1  Command  Sequence 

Type  the  same  command  sequence  as  given  in  6.3.I.I. 

6.3 - 3 ‘S.  Procedure 


a.  Start  at  initial  instruction  in  SFCHEX  with  JS  1  down. 

b.  Respond  to  MODE  IN  with  a  T  on  the  typewriter. 

c.  Respond  to  MODE  OUT  with  a  P  on  the  typewriter. 

d.  Each  time  the  typewriter  does  a  carriage  return  followed  by  an 
asterisk  type  in  the  next  command. 

Hit  the  carriage  return  before  typing  the  period  and  re-enter 
the  command.  This  will  indicate  that  erroneous  instructions 
may  be  changed. 

Acceptance  Criteria 


6.3. 3. 3 


The  results  should  be  identical  to  the  criteria  in  6. 3.1. 3-  This 
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will  Indicate  that  the  typewriter  mode  and  card  mode  give  identical  results 
and  also  that  SFCHEX  does  not  disturb  the  user's  program.  (Unless  an  indefi¬ 
nite  trap  were  placed  in  the  progrEun. ) 


6.3.4  Test  Four 

This  test  will  use  two  T,  two  S  and  two  U  commands  simultaneously 
to  veU-idate  the  table  lengths. 

6. 3. 4.1  CommATid  Card  Seq.uence 


COM 

COL.  4 

L 

03000 

H 

TEST  FOUR. 

T 

00105 

0002. 

S 

00107 

0. 

D 

00000 

00017. 

T 

00143 

00020. 

S 

00145 

4. 

D 

00020 

00037- 

B 

00100. 

T 

00177 

0000. 

U 

00107 

00107. 

U 

00145 

00145 . 

R. 

T 

00105 

0. 

H 

FINAL 

DUMP. 

D 

00000 

37777- 

E. 


INST.  MODE  TRANSLATED 


MODIC  MODIC 
MODIC  MODIB 

M0D9  MODIC 
MODIC  M0D2B 


M0D2A  M0D3 


MODIC  MODIC 


6. 3. 4. 2  Procedure 


a. 

b. 


Read  in  SFCHEX  program 
Read  in  SAMPIJE  user's  program 
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c.  Place  Command  Cards  in  Card  Reader 

d.  Start  at  Initial,  instruction  of  SFCHEX 

e.  Respond  to  MODE  IN  with  a  C  on  the  typewriter 

f .  Respond  to  MODE  OUT  with  a  Mx  (where  x  is  an  available  magnetic 
tape  unit). 

6. 3. 4. 3  Acceptance  Criteria 

a.  Output  will  be  on  magnetic  tape 

b.  Cards  will  read  in  from  the  on-line  card  reader 

c.  Program  will  terminate  at  0202  in  the  user’s  program 

d.  List  Magnetic  Tape  out  will  be 

e .  "TEST  FOUR" 

f.  Dump  O-I7  bamk  0 

g.  Dump  O-I7  bamk  0 

h.  Dump  20-37  bank  0 

i.  Dump  0-77  bank  0 

Dump  0-77  liank  1 
Dump  0-77  bank  2 
Dump  0-77  bank  3 

J .  Same  as  f 

k.  Same  as  h 

l.  "FINAL  DUMP" 

m.  Dun^)  of  core  memory 

6.3.5  Test  Five 

This  test  series  will  demonstrate  the  error  indications.  All  input 
will  be  typed. 

6.3. 5.1  Procedure 


a.  Load  SFCHEX 

b.  Load  SAMPIE  user's  program  into  bank  0. 

c.  Start  at  initial  cell  in  SFCHEX 
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d.  Respond  to  MODE  In  with  an  X 

SFCHEX  will  retype  MODE  IN 

e.  Respond  with  a  T 

f .  Respond  to  MODE  OUT  with  a  P 

g.  IVP®  'the  command  X  00100. 

SFCHEX  will  type  IL  CW4  euid  request  another  command. 

h.  Type  L  03000. 

H  TEST. 

"lEST"  will  appear  on  the  on-line  printer 

i.  Type  T  0202. 

This  is  an  illegal  format  .  SFCHEX  will  req.uest  another 
character. 

j.  Start  again  at  initial  cell  in  SFCHEX  by  using  B  command 

k.  Respond  to  MODE  IN  with  a  T 

l.  Respond  to  MODE  OUT  with  Mx  (where  x  is  an  avedlable  magnetic 
tape ) . 

m.  Type  the  following  commands: 

L  03000. 

T  00105  0000. 

T  OOlOT  0000. 

T  00122  0000. 

SFCHEX  will  type  out  "THIRD  COM" 

n.  Repeat  J  throu^  L 

o.  Type  the  following  ccmmands 

C  00105  0470  4001  0400  4100 

s  00105  0. 

U  00107  00107 

B  00105 . 

1.  SFCHEX  will  output  snap  on  tape  x 

2.  Since  Unsnap  command  does  not  agree  with  snap  command 
address,  SFCHEX  will  type  out: 
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"NO  S  AT  OOlOT" 

p.  Type  the  following  commands: 

C  00105  0470  4001  0400  4100. 

T  00105  0000. 

H  0102030405060708091011121314. 

H  0102030405060708091011121314. 

H  0102030405060708091011121314. 

At  this  point  49  cells  of  the  TRAP  TABLE  are  filled. 

Type  H  01. 

SFCHEX  will  type  out  "TT  OVRFLW",  the  typewriter  will  do 
a  carriage  return  and  type  an  *. 

At  this  point  the  trap  set  up  at  OOIO5  has  been  replaced  with 
the  original  instructions  and  the  trap  has  been  removed  from 
the  TAB  table.  Thus  this  location  may  be  trapped  again. 

The  test  is  completed. 
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T.O  PROGRAM  DESCRIPTION 


This  section  presents  both  a  verbal  and  a  drawn  flowchart  break¬ 
down  of  the  submodules  of  SFCHEX. 

The  program  naturally  divides  into  two  sections .  The  first  section 
deals  with  the  input,  setup  and  execution  of  the  commands.  The  second  section 
is  entered  whenever  u  Snap,  Trap  or  Unsnap  command  causes  a  transfer  from  the 
user's  program  to  SFCHEX. 

7.1  General  Considerations 

The  subroutine  and  section  descriptions  on  the  following  pages  con¬ 
centrate  principally  on  the  logical  processes  in  the  program.  Each  subroutine 
will  be  presented  in  sufficient  detail  so  that  any  individual  who  is  investi¬ 
gating  a  listing  of  SFCHEX  can  correlate  the  listing  with  the  flowcharts.  For 
this  purpose,  the  flowcharts  will  use  the  same  tags  as  appear  in  the  listing, 
rather  than  mnemonic  tags  which  would  have  more  contextual  meaning. 

Flow  Chart  Conventions 

(X)  Contents  of  X 

[^(X)J  Contents  of  address  specified 

by  contents  of  X 

- >  Assignment  (e.g.  1  - >{x)  ) 

(2)  Logical  product 

7.1.1  Tables  and  Buffers 

The  various  storage  tables  and  buffers  used  in  SFCHEX  will  be  ex¬ 
plained  in  this  section  so  that  their  use  in  the  flowcharts  will  not  necessi¬ 
tate  redundant  explanations. 

7. 1.1.1  BUF  Buffer  (4l  cells) 

The  BUF  Buffer  is  used  to  store  the  i)arameters  from  the  current 
input  command.  If  the  command  is  to  be  executed  or  set  up  immediately,  the 
data  will  be  taken  directly  from  BUF.  If  the  command  parameters  are  to  be 
saved  in  a  Trap  Table,  the  parameters  are  transferred  from  BUF  to  one  of  the 
two  Trap  Tables  (TT  Buffer) . 


12  Fetnaary  I963 


7-2 


TM-1003/002/00 


7. 1.1. 1.1  BBUFl  and  BBUF2,  the  HEED  Buffers  (6k  cells  apiece) 

These  two  huffers  are  stored  in  the  upper  portion  of  bank  3.  They 
are  used  by  the  NEED  and  UNNEED  Subroutines  for  storing  the  contents  of  the 
direct  cells  used  by  SFCHEX  and  the  user's  program.  This  allows  SFCHEX  to 
"borrow"  the  direct  cell  locations  for  more  efficient  operation  and  then  re¬ 
store  the  direct  cells  when  control  is  returned  to  the  user's  program. 

7. 1.1. 2  OUTBUF  Buffer  (36  cells) 

This  buffer  is  used  to  set  up  the  dunQ)  output  messages. 

7. 1.1. 3  SNTB  Table  (2  cells) 

This  table  contains  the  banks  which  are  to  be  "Snap"  dumped.  The 
proper  bank  in  SNTB  will  be  selected  according  to  the  original  position  of 
the  flagged  address  in  the  TAB  Table. 

7. 1-1. 4  SX  Table  (60  cells) 

SX  is  the  Snap  Instruction  Execution  Table.  It  is  divided  into  two 
30  cell  sections  corresponding  to  the  two  possible  Snap  commands.  This  buffer 
contains  the  translations  of  the  two  instructions  which  were  removed  from  the 
user's  program  when  a  Snap  command  was  setup.  Thus,  when  the  flagged  address 
in  the  user's  program  is  encountered,  SFCHEX  will  generate  the  Snap  dump  and 
then  transfer  to  the  proper  half  of  the  SX  Table  and  execute  the  translations 
contained  therein. 

7. 1.1.5  TAB  Table  (18  cells) 

When  a  Snap,  Trap  or  Unsnap  command  is  set  up,  SFCHEX  stores  a  JPR 
to  the  RECOV  Subroutine  in  the  user's  program  at  the  required  address.  This 
means  that  two  instructions  in  the  user's  program  must  be  saved  in  SFCHEX 
until  that  command  is  terminated. 

TAB  is  divided  into  three  6  cell  sections.  The  first  6  cells  will 
contain  the  user's  program  address  and  the  two  saved  instructions  for  the  two 
Trap  Commands.  The  second  set  of  6  cells  will  contain  the  addresses  and  in¬ 
structions  for  the  two  Unsnap  commands.  The  final  6  cell  sections  will  contain 
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the  address  and  instructions  for  the  two  Snap  commands.  As  stated  above, 
each  6  cell  section  is  divided  into  two  3  cell  subsections.  The  first  cell  of 
a  subsection  will  contain  the  address  in  the  user's  program  from  which  the 
instructions  were  teiken.  The  second  cell  will  contain  the  instruction  taken 
from  that  address.  The  third  cell  will  contain  the  instruction  taken  from  the 
location  immediately  following  that  address. 

TAB  serves  the  additional  function  of  bookkeeper  for  the  SX,  TX, 
UNSTBL  and  SNTB  Tables.  Whenever  a  flagged  jump  in  the  user's  program  is  en¬ 
countered,  the  address  from  which  the  jump  was  effected  will  be  compared  with 
the  addresses  in  the  TAB  Table.  Counters  are  set  so  that  when  the  proper 
address  is  found,  SFCHEX  will  be  able  to  pick  up  the  corresponding  elements 
in  the  TX,  SX,  UNSTBL  and  SHTB  Tables. 

In  order  to  keep  track  of  the  available  storage  in  the  TAB  Buffer, 
a  7777  is  stored  in  the  initiail  cell  of  each  3  cell  subsection  which  is  current¬ 
ly  not  in  use. 

7.1.1. 6  TT  Buffer  (100  cells) 

This  buffer  contains  the  two  Trap  Tables.  The  Trap  Tables  are  set 
up  so  that  the  nvunber  n  (number  of  times  the  trap  is  to  be  executed)  is  con¬ 
tained  in  the  first  cell  of  the  table.  As  subsequent  ccmmands  are  processed, 
the  address  of  the  corresponding  command  execution  subroutine  euid  the  pertinent 
pea^meters  will  be  stored  in  the  table.  When  another  Trap  command  or  a  Begin, 
Run,  End  or  Wrapup  command  is  read,  a  777  is  stored  after  the  last  parameter 
in  the  Trap  Table. 

Thus,  when  a  Trap  Table  is  executed,  the  n  in  the  initisJ.  cell  will 
be  reduced  by  one.  Then  a  transfer  will  be  made  to  the  first  conmand  execution 
address  in  the  Trap  Table.  The  command  execution  subroutine  will  pick  up  its 
parameters  from  the  Trap  Table.  When  the  command  function  is  completed,  it 
will  return  control  in  such  a  manner  that  the  address  of  the  next  subroutine 
to  be  executed  from  the  Trap  Table  will  be  readily  available.  When  the  7777 
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at  the  end  of  the  Trap  Table  is  sensed,  the  Trap  Table  execution  is  completed. 

7. 1.1. 7  TX  Table  (60  cells) 

This  is  the  counterpart  of  the  SX  Table  for  the  Snap  command.  TX 
is  the  Trap  Instruction  Execution  Table.  It  is  divided  into  two  30  cell 
sections  corresponding  to  the  two  possible  Trap  commands .  This  buffer  contains 
the  translations  of  the  two  instructions  which  were  removed  from  the  user's 
program  when  a  Trap  command  is  set  up.  Thus, when  the  flagged  address  in  the 
user's  program  is  encountered,  SFCEEX  will  execute  the  corresponding  Trap  Table 
and  the  transfer  to  the  proper  hadf  of  the  TX  Table  and  execute  the  trans¬ 
lations  contained  therein. 

7. 1.1. 8  TYPBCD  Table  (64  cells) 

This  is  the  typewriter  BCD  code  conversion  table. 

7. 1.1. 9  UNSTBL  Table  (2  cells) 

This  table  contains  the  addresses  of  Snap  commands  which  are  to  be 
removed  when  the  flagged  jun^j  for  the  corresponding  Unsnap  command  is  en¬ 
countered. 


7.2  Input,  Setup  and  Exeuction  Section  (Figure  7.I) 

Figure  7.I  shows  the  initial  breakdown  of  this  section. 

The  procedure  is: 

a.  Upon  entry,  if  junQ)  switch  2  is  set,  SFCHEX  will  transfer 
immediately  to  the  NEED  Subroutine  (step  e).  This  switch  is 
used  only  when  there  has  been  a  card  input  error. 

b.  Certain  switches  and  buffers  are  initiaJ-ized.  Since  SFCHEX  is 
bank  independent,  the  relative  bank  for  SFCHEX  is  determined 
and  stored. 
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c.  If  jump  switch  1  is  set,  the  program  will  skip  step  d.  This 
allows  the  user  to  keep  the  same  input  and  output  modes  as  were 
used  for  the  previous  run. 

d.  Next,  the  input -output  options  are  set  up  (Section  7-2.1 ). 

e.  The  NEED  Subroutine  is  called  (Section  7-2.2).  This  subroutine 
saves  the  contents  of  the  user's  direct  cells,  ajid  stored  SFCHEX 
parameters  in  the  direct  cells. 

f.  Finally,  the  command  input  section  (Section  7-2.3  -  7-2.3-13) 
is  entered  and  the  initial  commands  are  entered  and  set  up 
or  executed.  When  all  the  initial  commands  have  been  entered, 
SFCHEX  will  transfer  control  to  the  bank  and  address  indicated 
by  the  Begin  command. 

7.2.1  I-O  Section  (Figure  7-2) 

This  section  establishes  the  input  and  output  options  and  verifies 
equipment  status  for  the  desired  modes. 

The  procedure  is : 

a-  "MODE  IN"  is  written  on  the  on-line  typewriter.  The  answering 
T  or  C  is  stored  in  Input. 

b.  If  C  is  the  indicated  option,  the  card  reader  status  is  tested 
until  the  card  reader  is  ready. 

c.  "MODE  OUT"  is  then  written  on  the  on-line  typewriter.  The 
answering  P  or  MX  is  stored  in  OUT  2. 

d.  The  output  equipment  status  is  tested  until  the  equipment  is 
reaAy. 
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e.  Go  to  BETA,  the  tag  for  the  jun^)  to  the  NEED  Subroutine 
(Figure  1). 

T.2.2  NEED  Subroutine  (Figure  7»3) 

The  NEED  Subroutine  is  used  to  save  the  direct  cells  in  the  user's 
relative  bank  so  that  SFCHEX  may  use  those  cells  for  storage  and  transferral 
of  data. 
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Figure  7.I 


Input,  Setup  and  Execution 


12  February  1963 


7-8 


TM-1003/002/00 


C 


Figure  7.3  NEED  Subroutine 
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The  procedure  is: 

a.  Test  NDFL.  0  -  go  to  step  h.  If  NDFL  does  not  equal  zero,  then 
the  information  has  already  been  treuisferred.  To  to  step  6. 

b.  Find  the  buffer  bank  and  store  it  in  NDFL. 

c.  Find  the  user's  relative  bank. 

d.  Transfer  the  direct  cells  in  the  user's  relative  bank  to  DBUFl. 

e.  Trajisfer  the  contents  of  DBUF2  into  the  direct  cells  of  the  user's 
relative  bemk. 

7.2.3  Command  Input  (Figure  7.^<-) 

Figure  7.4-  is  schematic  representation  of  the  multiple  switch  in¬ 
volved  in  transferring  to  the  proper  command  interpretation  Subroutine. 

Thus  the  command  is  read  in  BCD  format  into  the  BUF  Buffer.  As  shown 
in  the  Input  Section  (Section  2)  the  mnemonic  letter  representing  the  command 
is  eJ.vays  in  column  one,  and  is  therefore  read  into  the  first  cell  of  BUF.  The 
contents  of  this  cell  are  compared  with  stored  BCD  characters  and  the  corres¬ 
ponding  subroutine  is  entered.  If  no  character  match  is  found  the  error  sub¬ 
routine  EX2  is  executed, resulting  in  the  following  printout  on  the  on-line 
typewriter. 

"IL  COM" 

The  following  sections  (7-2. 3. 2  thru  7'2.3"13)  deal  with  the  pro¬ 
cessing  of  the  individual  commands. 

7. 2. 3-1  BUF  Buffer,  Trap  Table  and  SVQ. 

The  BUF  BUFFER  contains  the  BCD  character  as  read  in  through  the  in¬ 
put  medium.  The  individual  subroutines  will  convert  the  BCD  characters  into 
the  corresponding  parameters  and  restore  them  in  the  BUF  Buffer  in  the  correct 
parameter  sequence.  To  save  instructions,  the  BUF  Buffer  is  located  in  the 
direct  cells  of  the  user's  relative  bank. 
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Figure  7.i^  Coramand  Test  Sequence 
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SWl  is  the  switch  used  for  keeping  track  of  whether  the  next  input 
command  is  to  be  stored  in  the  Trap  Table  or  if  it  is  to  be  immediately  set 
up  or  executed.  If  SWl  equals  1,  the  former  situation  is  indicated  and  if 
SWl  equsJ-s  0,  the  latter  situation  is  indicated.  (See  Sections  7»l*3-2  thru 
7.2.3.13)- 

In  the  case  where  SWl  equals  1,  the  converted  parameters  which  would 
normally  be  restored  in  the  BUF  Buffer  are  stored  instead  in  the  current  Trap 
Table.  The  next  available  address  in  the  Trap  Table  is  contained  in  the  direct 
cell  labeled  GDI. 

7.2. 3 .2  CXB  Begin,  Command  -  (Figure  7-5) 

The  Begin  Command  is  used  to  terminate  the  initial  sequence  of  com¬ 
mands  and  to  indicate  the  address  and  bank  to  which  SFCHEX  is  to  transfer  con¬ 
trol.  (This  address  will  normally  be  the  location  of  the  initial  instruction 
of  the  user's  program.) 

When  CXB  is  entered,  SWl  is  initially  tested.  SWl  will  equal  1  if 
the  last  command  was  inserted  in  a  Trap  Table.  SWl  will  equal  0  if  the  last 
command  was  not  associated  with  a  TRAP  Table. 

The  procedure  followed  is; 

a.  Test  SWl.  0  -  go  to  step  d.  1  -  continue. 

b.  Store  7777  in  the  next  available  location  in  the  Trap  Table  (via 
CDl,  which  contains  the  address  of  that  cell).  This  will  ter¬ 
minate  the  Trap  Table. 

c.  Set  SWl  to  0.  This  will  initialize  the  input  section  for  the  next 
input  command  sequence. 

d.  Call  XADD  Subroutine.  This  will  cause  the  characters  in  BUF+1 
through  BUF+3  to  be  converted  to  the  beuik  number  and  the  address 
which  will  be  stored  in  BUF+1  and  BUF+2  respectively. 
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e.  Call  UUMEED  Subroutine.  This  will  transfer  the  parameters  in  the 
direct  cells  of  the  user's  relative  bank  to  DBUF2.  Then  the  para¬ 
meters  in  DBUFl  will  be  transferred  to  the  direct  cells  in  the 
user's  relative  bank. 

f.  Transfer  to  the  address  and  bank  stored  in  BIJF+2  and  BUF+1  res¬ 
pectively. 

7-2. 3. 3  CXC  Correct  Command  (Figure  7-6) 

The  Correct  Command  enters  up  to  11  corrections  sequentially  starting 
at  the  indicated  address  and  bank. 

The  procedure  is : 

a.  Test  SWl.  0  -  go  to  step  q.  1  -  continue. 

b.  The  address  of  the  CORRECT  Subroutine  is  placed  in  the  next 
available  location  in  the  TRAP  Table  using  CDl.  Thus,  when  the 
TRAP  Table  is  executed  for  the  first  time,  CORRECT  will  be  called 
and  the  corrections  will  be  transferred  from  the  TRAP  Table  to  the 
desired  location. 

c.  Increase  CDl  by  one  and  call  OVF  Subroutine.  OVF  merely  checks  to 
see  if  a  Trap  Table  overflow  has  occurred.  An  overflow  will  cause 
the  Trap  Table  to  be  deleted  and  transfer  to  BET2.  (Figure  7-^)- 

d.  Call  XADD.  This  subroutine  picks  up  the  contents  of  BUF+1  thru 
BUF+3  and  stores  the  resulting  bank  and  address  via  CDl. 

e .  The  contents  of  CDl  is  increased  by  2  and  stored  in  DTR.  (The 
number  of  corrections  (CD3)  will  be  stored  in  the  address  stored 
in  DTR. ) 

f.  Increase  CDl  by  1. 
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g.  Set  CD2  to  address  in  BUF  where  the  first  correction  parameters 
are  stored. 

h.  Does  (CD2)  contain  a  period?  Yes  -  go  to  step  n,  no  -  continue. 

i.  Use  BINC  Subroutine  to  convert  the  BCD  characters  in  (CD2)  and 
(CD2+1)  to  a  binary  parameter. 

j.  Store  the  result  in  the  Trap  Table  via  CDl.  Increase  CDl  by  1. 

k.  Call  OVF  Subroutine.  If  the  Trap  Table  has  overflowed,  the  table 
will  be  removed.  TT  OVRFLW  will  appear  on  the  typewriter  and 
SFCHEX  will  transfer  to  BET2  or  stop  depending  on  the  input  option. 

l.  Increase  CD2  by  2,  Increase  CD3  by  1. 

m.  Go  to  step  h. 

n.  At  this  point,  all  the  corrections  have  been  stored.  CD3  con¬ 
tains  the  number  of  corrections  and  is  stored  in  the  location 
whose  address  was  saved  in  DTK. 

o.  Increase  CDl  by  one. 

p.  Go  back  to  BET2  and  input  the  next  command. 

q.  Since  SWl  was  set  to  0,  the  correction  will  be  executed  immediately. 

r.  Steps  d  thru  m  are  executed  with  the  appropriate  BUF  address  in¬ 
serted  in  CDl.  This  results  in  the  bank  and  address  stored  in 
BUF+1  and  BUF+2,  the  number  of  corrections  in  BUF+3,  and  the  N 
corrections  stored  in  BUF+4  thru  BUF+N+3. 

s.  Call  CORRECT  Subroutine  (Section  7* 3*1)  with  the  address  of  BUP 
in  CDl.  CORRECT  will  store  the  corrections. 

t.  Go  back  to  BET2  emd  input  the  next  command. 


t 
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Figure  7.5  CXB 
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Figure  7 • 6  GCC 
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Figure  7.7 
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7-2. 3.4  CXD  Dump  Command  (Figure  7-7) 

This  command  causes  a  dump  of  specified  limits  to  be  effected. 

The  procedure  is: 

a.  Test  SWl.  0  -  go  to  step  i.  1  -  continue. 

b.  Store  address  of  DUMP  Subroutine  in  the  TRAP  Table  via  GDI. 

c.  Increase  GDI  by  one. 

d.  Use  XADD  to  get  lower  limit  of  dump.  (This  will  be  stored  in 
the  TRAP  Table  via  GDI. ) 

e.  Increase  GDI  by  2. 

f .  Use  XADDA  to  convert  the  contents  of  BUF+4  thru  BUF+6  to  the 
upper  limit  of  the  dump.  XADDA  is  the  counterpart  of  XADD,  only 
it  deals  with  the  contents  of  BUF+4  thru  BUF+6. 

g.  Store  the  contents  of  GDI  in  DJR. 

h.  Go  to  BET2  and  input  the  next  command. 

i.  Perform  steps  c  thru  h  with  the  appropriate  BUF  address  in  GDI. 
J.  Call  DUMP  Subroutine  (Section  7'3-2). 

k.  Go  to  BET2  and  input  the  next  command. 
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7. 2. 3-5  CXE  End  Command  (Figure  7«8) 

The  comniand  is  used  to  indicate  that  no  more  commands  are  to  be  in¬ 
put. 

The  procedure  is ; 

a.  Test  SVn..  0  -  go  to  step  d.  1  -  continue. 

b.  Terminate  TRAP  Table  with  a  7777-  (Stored  through  CDl). 

c.  Set  SWl  to  0. 

d.  Set  NOPUT  Switch  to  1.  This  switch  will  be  tested  ^enever  a 
TRAP  Table  is  flushed.  If  NOPUT  is  set  to  1,  SFCHEX  will  not 
attempt  to  input  any  more  commands. 

e.  Call  UNNEIED  Subroutine  to  restore  the  user's  program  direct  bank. 

f.  Go  to  A32.  This  is  a  location  in  the  PREX  Subroutine  from  which 
SFCHEX  will  transfer  control  to  user’s  program. 
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Figure  7.8 
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7-2. 3-6  CXH  Headlnp;  Command  (Figure  7.9) 

This  command  is  to  generate  a  BCD  command  on  the  on-line  printer  or 
on  magnetic  tape  according  to  the  user's  indicated  option. 

The  procedure  is : 

a.  Test  SWl.  0  -  go  to  q.  1  -  continue. 

b.  Store  the  address  of  the  HEAD  Subroutine  in  the  TRAP  Table  via  DTR. 

c .  Increase  DTR  by  one .  Store  DTR  in  CDl . 

d.  Call  OVF  Subroutine.  If  the  TRAP  Table  has  overflowed,  the  table 
will  be  removed.  TT  OVEDFLW  will  appear  on  the  typewriter,  and 
SFCHEX  will  transfer  to  BET2  or  stop  depending  on  the  input  mode. 

e.  Store  -4o  in  CD3- 

f .  Store  BUF+1  in  CD2  so  that  BCD  characters  can  be  picked  up. 

g.  Increase  CDl  by  1  to  leave  room  in  the  TRAP  Table  for  the  number 
(divided  by  two)  of  BCD  characters. 

h.  Call  OVF  Subroutine. 

i.  Pick  up  BCD  character  pair  via  CD2  and  store  them  in  the  TRAP 
via  CDl. 

J.  Was  one  of  the  characters  a  period. 

Yes  -  go  to  step  m. 

No  -  continue . 

k.  Increase  CD2  and  CD3  by  1. 

l.  Is  CD3  now  zero  (there  sure  no  more  characters) 

Yes  -  continue. 

No  -  go  back  to  step  g. 
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m.  Store  number  of  character  pairs  (ij-l  -  the  number  in  CD3)  in  the 
proper  position  in  the  TRAP  Table  via  DTR. 

n.  Increase  GDI  by  1. 

o .  Call  OVF  Subroutine . 

p.  Go  to  BET2  and  input  next  command. 

q.  Set  DTR  to  the  start  of  the  BCD  characters . 

r.  Call  HEAD  Subroutine. 

s.  Go  to  BET2  and  input  next  command. 
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7. 2. 3. 7  CXL  LOCATE  COMMAND  (Figure  7-10) 

This  commaiid  indicates  to  SFCHEX  a  location  in  the  user's  relative 
bank  in  which  the  RECOV  Subroutine  (Section  7. 3-4.1)  may  be  stored.  This 
command  must  have  been  entered  before  any  S,  U  or  T  commands. 

The  procedure  is : 

a.  Call  XADD.  Now  BUF+1  contains  the  user's  relative  bank  number  and 
BUF+2  the  initial  address  of  the  RECOV  Subroutine. 

b.  Call  LOCATE  Subroutine  (Section  7-3-4).  This  subroutine  will  store 
the  RECOV  Subroutine  in  the  user's  relative  bank  and  also  store 
certain  communication  parameters  for  the  intercommunication  between 
SFCHEX  and  the  user's  program. 

c.  Get  to  BET2  and  input  the  next  command. 

7. 2. 3. 8  CXP  PAGE  COMMAND  (Figure  7-11) 

This  command  sets  up  a  page  eject  for  the  output  listing. 

The  procedure  is : 

a.  Test  SWl.  0  -  go  to  step  f.  1  -  continue. 

b.  Address  of  PAGE  Subroutine  is  stored  in  TRAP  Table  via  DTR. 

c.  Increase  DTR  by  one. 

d.  Call  OVF  Subroutine  for  possibility  of  TRAP  Table  overflow. 

e.  Go  to  BET2  and  input  the  next  command. 

f.  CeGJ.  PAGE  Subroutine.  PACSI  merely  causes  a  page  eject  (it  is  not 
flowcharted) . 

g.  Go  to  BET2  and  input  the  next  command. 
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Figure  J.IO 
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7. 2. 3. 9  CXR  RUN  COMMAND  (Figure  7-12) 

This  connnand  is  used  to  terminate  a  sequence  of  command  input. 

The  procedure  is: 

a.  Test  SWl.  0  -  go  to  step  d,  1  -  continue. 

b.  Store  a  7777  in  the  TRAP  Table  via  DTR. 

c.  Set  SWl  to  0. 

d.  Call  UNNEED  Subroutine  to  replace  user's  direct  bank. 

e.  Go  to  A32  (returns  to  proper  location  in  user's  program). 

7.2.3.10  CXS  SNAP  COMMAND  (Figure  7.13) 

This  command  sets  up  a  location  in  the  user's  program  which,  when 
encountered,  causes  SFCHEX  to  dump  the  direct  cells  of  an  indicated  bank. 

The  procedure  for  setting  up  this  command  is: 

a.  Test  SWl.  0  -  go  to  i.  1  -  continue. 

b.  The  address  of  the  Snap  Setup  Subroutine  (SNST)  is  placed  in  the 
TRAP  Table,  via  CDl. 

c.  Increase  CDl  by  one.  Call  OVF  Subroutine. 

d.  Csdl  XADD.  The  bank  and  location  of  the  snap  flag  are  stored  in 
the  TRAP  Table  via  CDl. 

e.  Increase  CDl  by  2.  Call  OVF  Subroutine. 

f.  CaJ.1  BIN.  This  will  be  the  bank  to  be  snapped.  It  will  also  be 
stored  in  the  TRAP  Table  via  CDl. 

g.  Increase  CDl  by  1.  Call  OVF  Subroutine. 
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h.  Go  to  BET2  smd  input  the  next  command. 

i.  Perform  steps  d  throu^  f  with  the  address  of  the  appropriate 
location  in  the  BUF  Buffer  initiedly  stored  in  GDI. 

j.  Call  oNST.  This  is  the  SNAP  SETUP  Subroutine  (Section  7-3. 5). 

k.  Go  to  BET2  euid  input  the  next  command. 


c 
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Figure  7-12 
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Figure  7.I3  CXS 
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7.2.3-11  CXT  TRAP  COMMAMD  (Figure  7.1^) 

This  command  indicates  that  the  parameters  from  subsequent  commands 
are  to  be  stored  in  a  TRAP  Table. 

The  procedure  is : 

a.  Test  SWl.  0  -  go  to  step  c.  1  -  continue. 

b.  Terminate  previous  TRAP  Table  with  a  7777  via  DTR. 

c.  Call  XADD  Subroutine  to  get  Trap  Address  auid  bank. 

d.  Pick  up  BUF+5.  If  blank,  store  -1  in  the  BUF  Buffer.  If  not 
blank,  use  BINC  to  convert  the  BCD  number  to  binary. 

e.  If  the  BCD  number  is  0,  store  a  1  in  the  BUF  Buffer,  otherwise 
store  the  number. 

f .  Store  a  zero  in  T2+1  and  T1  (these  are  parameters  for  subsequent 
subroutines).  Set  SWl  to  1. 

g.  Call  INSV  (Section  7.3.6).  This  subroutine  saves  the  instructions 
which  are  removed  from  the  user’s  program,  stores  the  jump  to 
RECOV  in  that  location,  picks  an  available  TRAP  Table  and  in¬ 
itializes  DTR. 

h.  Call  SETUP  (Section  7-3-7).  This  subroutine  translates  the  saved 
instructions  so  that  they  can  be  executed  in  the  bank  in  which 
SFCHEX  is  located. 

i.  Go  to  BET2  and  input  the  next  command. 
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7.2.3.12  CXU  UNSNAP  Command  (Figure  7-13) 

This  command  sets  up  a  location  in  the  user's  program  vhich,  when 
encountered,  will  cause  a  snap  location  in  the  user's  program  to  he  removed. 

The  procedure  is: 

a.  Test  SWl.  0  -  go  to  step  i.  1  -  continue. 

h.  Address  of  UNST  Subroutine  is  stored  in  the  TRAP  Table  via  GDI. 

c .  Increase  GDI  by  one .  Gall  OVF  Subroutine . 

d.  Gall  XADD  -  the  unsnap  address  and  bank  will  be  placed  in  the 
TRAP  Table. 

e.  Increase  GDI  by  two.  Gall  OVF  Subroutine. 

f .  Gall  XADDA  -  the  address  and  bank  of  the  snap  address  which  is 
to  be  removed  will  be  placed  in  the  TRAP  Table. 

g.  Increase  GDI  by  one.  Gall  OVF  Subroutine. 

h.  Go  to  BET2  and  input  the  next  command. 

i.  Call  XADD  -  unsnap  bank  is  in  BUF+1,  unsnap  address  is  in  BUF+2. 

J .  Call  XADDA  -  bank  of  snap  command  to  be  removed  is  in  BUF+3 • 
Address  is  in  BUF+4. 

k.  Call  UKST  (Section  7.3.8).  This  subroutine  sets  up  a  flag  Jump 
in  the  user's  program  for  the  unsnap  execution. 

l.  Go  to  BET2  and  input  next  command. 
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CXD6 


Figure  7 '15  CXU 
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T-2.3-13  CXW  WBAPUP  Command  (Figure  l.lS) 

This  command  causes  the  termination  of  input  as  well  as  the  ter¬ 
mination  of  the  program  when  all  the  (finite)  TRAP  TABLES  have  been  flushed. 

The  procedure  is: 

a.  Test  SWl.  0  -  go  to  step  d.  1  -  continue. 

b.  Store  a  7777  in  the  TRAP  Table  via  GDI. 

c.  Store  a  0  In  SWl. 

d.  Set  NOPUT  Switch  to  1.  Set  TERM  Switch  to  1.  The  TERM  switch 
initiates  the  test  of  the  TRAP  Tables. 

e.  Call  UNNEED  Subroutine  to  return  user's  program  direct  cells. 

f .  Pick  up  TT.  If  the  contents  of  TT  do  not  equal  0  or  -1,  go  to 
A32.  If  they  do  equal  0  or  -1,  continue. 

g.  If  TT+50  contains  0  or  -1,  stop.  Otherwise,  go  to  A32. 
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Figure  T.16  CXW 
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7.2.3.14  CXN  Mnemonic  dump  (Figure  7.17) 

This  conmand  causes  core  to  be  printed  in  60  word  blocks  without 
conversion. 

The  procedure  is: 

a.  Change  the  references  to  the  DUMP  subroutine  to  ALPHAD,  which 
is  the  address  of  mnemonic  dump  subroutine.  The  changes  are 
made  in  CXD  routine. 

b.  Transfer  to  CXD. 

c.  CXD  restores  the  DUMP  address  after  executing  the  mnemonic  dump. 
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Figure  7.17 


CXN 
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7.2.4  OVF  and  EX5 

These  two  subroutines  appearing  in  many  flow  charts  are  relatively 
simple  and  do  not  require  a  flow  chart. 

OVF  Subroutine  compares  the  address  in  GDI  with  the  address  of  the 
limit  of  the  Trap  execution  table.  If  the  limit  is  exceeded,  the  Trap  is 
wiped  out  by  replacing  the  instructions  in  the  user's  program  (RECOV  Subroutine), 
and  placing  a  zero  in  SWl. 

The  EX5  is  called  to  print  out 

TT  OVRFLW 

If  the  input  mode  is  via  typewriter,  an  asterisk  will  be  printed 
and  the  user  may  reenter  a  modified  table.  If  the  input  mode  is  via  punched 
card,  the  program  will  stop  to  allow  the  user  to  modify  the  card  sequence. 

7.3  Common  Subroutines 

The  following  set  of  subroutines  are  used  in  both  the  setup  and 
execution  of  the  instructions  as  they  are  read  in  (Section  7.2)  and  the  exe¬ 
cution  of  the  TRAP  Tables. 

7.3.1  CORR  Correct  Subroutine  (Figure  7.17A) 

This  subroutine  places  the  corrections  in  the  proper  location.  The 
storage  sequence  in  either  the  BUF  Buffer  or  a  TRAP  Table  is 

A  1  bank 

A  2  address 

A3  N  -  number  of  corrections 

A  4  corrections 


A 


+N+3 


correction 
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The  procedure  Is : 

a.  Decrease  DTR  by  1. 

b.  Compute  -(N+3)  anl  store  the  result  in  the  TRAP  Table  via  DTR. 
This  will  cause  subsequent  TRAP  executions  to  bypass  this  region. 

c.  Increase  DTR  by  1,  and  pick  up  the  bank  number  (Al).  Store  the 
set  bank  instruction  in  CRl+2. 

d.  Increase  DTR  by  1  and  pick  up  the  address  (A2).  Store  it  in 
CRI+4. 

e.  Increase  DTR  by  1  and  store  A3  (the  number  of  corrections)  in 
CR2. 

f.  Increase  DTR  by  1  and  store  the  contents  of  DTR  in  CRl+1. 

g.  Add  CR2  to  DTR  (for  the  execution  of  the  next  portion  of  the 
TRAP  Table. 

h.  Pick  up  the  corrections  via  CRl+1. 

i.  Set  to  user's  bank  in  CRl+2. 

J.  Store  the  corrections  via  CRl+1. 

k.  Increase  the  address  in  CRl+1  and  CRl+1. 

l.  Decrease  CR2  by  1.  Test  CR2.  0  -  exit.  Nonzero  -  return  to 
step  h. 
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7*3*2  DUMP  Subroutine  (Figure  7-l8) 

This  subroutine  can  be  called  directly  from  the  input  section,  from 
a  TRAP  Table  of  from  the  SNAP  Subroutine  (Section  ,7*^ • 6).  The  sequence  of 
setup  parameters  is_  the  same  in  each  case. 


A1  beink  1 

A2  address  1  start  of  dump 

A3  bank  2 

a4  address  2  end  of  dump 


The  procedure  is: 

a.  The  address  A1  is  contained  in  DTR.  Bank  1  is  stored  in  DBNKS  via 
Dl. 


b.  Increase  DTR  and  Dl  by  1.  Store  address  1  in  DST  via  Dl. 

c.  Increase  DTR  and  Dl  by  1.  Store  bank  2  in  DBNKT  via  Dl. 

d.  Increase  DTR  and  Dl  by  1.  Store  address  in  DTERM  via  Dl. 

e.  If  DSPFLG  is  zero,  the  DUMP  Subroutine  was  called  from  a  TRAP 
Table  or  from  a  SNAP  Subroutine.  In  this  case  the 

B  D  I  R  A  P  BER  heading  is  generated  in  the  bank  setting. 
A-Register,  instructions  address  and  Buffer  Entrance  Register 
values  are  printed. 

f.  UNNEED  Subroutine  is  called  in  order  to  set  the  ri^t  parameters 
in  the  direct  cells. 

g.  Subtract  DBNKS  from  DBNKT.  If  non-zero  go  to  step  h,  otherwise 

store  1  in  FLG77^  store  DTERM  in  D38  auid  go  to  step  i. 

h.  Store  0  in  FLG77  and  7777  in  D38. 
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i.  Truncate  the  address  in  DST  to  the  nearest  multiple  of  16.  (This 
is  done  to  give  even  octal  20  address  down  the  left  side  of  the 
dump. ) 

j .  Pick  up  and  convert  to  BCD,  I6  cells  starting  with  the  address  in 
DST.  Increase  DST  by  20. 

k.  Output  the  line,  and 

l.  Subtract  DST  from  D39'  Positive  go  to  step  10  -  zero  or  negative 
continue. 

m.  Test  FLGT7  0  -  Call  NEED  Subroutine  and  exit. 

1  -  Store  0  in  DST, increase  DBNKS  by  1  and  go  to 
step  g. 


Figure  7.17A  CORE 
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7.3-3  HEAD  SuTproutlne  (Figure  7.19) 

This  subroutine  outputs  the  BCD  annotations  which  were  input  via  the 

H  Conmand. 


The  sequence  of  parameters  is  the  same  for  the  two  sections  which 
call  the  HEAD  Subroutine. 

BUF  Buffer  TRAP  Table 


A1  39  A1  N 

A2  Hg  A2  H^ 


^+1  ^2N-1  ^2N  ^I+l  ^2N-1  ^2N 

In  the  BUF  Buffer,  the  whole  buffer  is  output  with  the  following 

blanks . 


The  procedure  is : 

a.  DTR  contains  the  address  Al.  Store  the  contents  of  A1  in  CDl 
via  DTR.  Store  the  initial  address  of  the  Output  Buffer  (OUTBUF) 
in  CD2. 

b.  Store  the  contents  of  Al  in  CD3  via  CDl.  Increase  CDl  by  1. 

c.  Transfer  characters  to  OUTBUF  using  CDl  and  CD2. 

d.  Increase  CDl,  CD2  emd  CD3  by  1. 

e.  Test  CD3  0  -  go  to  step  f 

1  -  go  to  step  c 

f.  Output  the  euinotaticn. 
g* 


Exit. 
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Figure  7-19  HEAD 
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7.3*^  LOG  Locate  Subroutine  (Figure  7-20) 

This  subroutine  transfers  the  RECOV  Subroutine  (Section  7-3'^-l)  to 
the  address  and  bank  indicated  by  the  L  command.  (Note:  This  subroutine  can 
only  be  called  from  the  Input  Section. ) 

The  calling  sequence  will  be  in  the  BUF  Buffer. 

BUF+1  Bank 

BUF+2  Address 

The  procedure  is : 

a.  Store  the  bank  in  BUF+1  in  UR  Md  CL2+1.  Store  the  address  in 
BUF+2  in  various  return  addresses. 

b.  Store  9  in  LC3. 

c.  The  first  cell  of  RECOV  is  RCS.  Pick  up  the  contents  of  RCX  and 
store  it  in  the  user's  program  via  LC2+1. 

d.  Decrease  LCS  by  1  and  increase  RCX  by  1. 

e.  Test  LC3.  0  -  return  to  BET2. 

Nonzero  -  to  step  c. 
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Figure  7*20 


LOG 
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7. 3-4.1  RECOV  Subroutine  (Figure  7.21) 

The  RECOV  Subroutine  is  the  link  between  the  user's  program  and 

SFCHEX. 

AS,  T  or  U  command  causes  a  JPR  to  RECOV  to  be  stored  in  2  cells 
at  an  indicated  address.  With  that  address  the  following  procedure  is  followed: 

a.  Save  A-Register  in  RECOVA. 

b.  Go  to  SFCHEX  ENTRY  (executes  S,  T  or  U  commaJid). 

c.  Restore  A-Register  (may  have  been  modified  by  SFCHEX). 

d .  Clear  lockout . 

e.  Return  to  user's  program  at  location  set  by  SFCHEX. 

T 

4^ 
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Figure  7.21 


RECOV 
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7.3-5  SNST  Subroutine  (Figure  7-22) 

This  subroutine  sets  up  the  SNAP  command  in  the  user's  program. 

The  calling  sequence  is  either  in  the  TRAP  Table  or  in  the  BUF  Buffer. 

A1  bank 

A2  address 

A3  bank  to  be  snapped 

Procedure : 

a.  Set  T3+1  to  12  and  T1  to  2.  These  are  parameter  settings  for  the 
following  subroutines. 

b.  -4  is  stored  via  DTR.  If  the  calling  sequence  is  in  the  TRAP 
Table,  the  -4  will  cause  the  TRAP  execution  to  bypass  this  section 
of  the  TRAP  Table,  next  time  throu^.  If  the  sequence  is  in  the 
BUF  Buffer,  no  harm  is  done. 

c.  CeQ-l  INSV.  IHSV  will  save  the  instructions  in  the  user's  program, 
set  the  Jump  to  RECOV  in  the  user's  program,  store  the  bank  to  be 
snapped  and  return. 

d.  CsQ-l  SETUP.  This  subroutine  will  translate  the  instructions 
which  were  saved,  so  that  they  may  be  executed  in  SFCHEX'  re¬ 
lative  bank, 

e .  Return , 


12  February  1963 


7-52 


TM-1003/002/00 


Figure  7-22 


SNST 


4 
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7.3-6  INSV  Subroutine  (Figure  7-23) 

This  subroutine  saves  the  two  cell  locations  in  the  user's  program* 
which  are  to  be  replaced  by  a  JPR  to  RECOV. 

The  following  two  parameters  are  set. 

T1  =0  Saving  for  a  T  Command 
=  1  Saving  for  a  U  Command 
=  2  Saving  for  a  S  Command 

T3+1  =  0  for  a  T  Command 

=  6  for  a  U  Command 
=  12  for  an  S  Command 

Tab  Buffer 

The  Tab  Buffer  consists  of  18  cells  divided  into  3  six  cell  sections. 
These  six  cell  sections  are  in  turn  divided  into  two  3  cell  sections.  Each  of 
these  3  cell  sections  may  contain  an  address  emd  the  contents  of  two  cells  from 
the  user's  program.  The  six  cell  sections  can  contain  up  to  two  sets  of  saved 
•  instructions.  Thus  T3+2  is  set  so  that  INSV  will  immediately  check  the  proper 

portion  of  TAB  for  available  locations.  (0-5  for  T,  6-11  for  U,  12-17  for  S). 

The  bank  and  address  at  which  the  jump  to  RECOV  is  to  be  placed  are 
either  in  the  BUF  Buffer  or  a  TRAP  Table  (in  the  case  of  a  T  command,  they  could 
only  be  in  the  BUF  Buffer). 


TRAP 

UNSNAP 

SNAP 

A1 

bank 

bank  1 

beinkk 

A2 

address 

address  1 

address 

A3 

n 

bank  2 

snap  beuik 

A4 

address  2 
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Procedure : 

a.  Get  initial  position  in  the  TAB  buffer  by  adding  the  initial 
address  of  TAB  to  the  contents  of  T3+1  and  store  the  result  in 
T3+1. 

b.  Increase  DTR  by  1.  DTK  now  contains  the  address  A2. 

c.  Pick  up  the  contents  of  A2  and  store  it  in  CD2,  increase  CD2  by 
1  and  store  it  in  CD3- 

d.  Store  a  -1  in 

e.  Pick  up  the  location  in  the  TAB  Buffer  identified  by  T3+1'  If 
7777 j go  to  step  g.  If  not  7777 > continue. 

f.  Increase  CD4  by  1.  If  0^  increase  T3+1  hy  3  and  return  to  step  e. 
If  1,  then  we  already  have  the  TAB  Buffer  filled  with  this  type  of 
command.  EX5  is  called  to  print  out  THIRD  COM. 

g.  Store  this  available  TAB  address  in  CD5.  Increase  it  by  1  and 
store  in  CD6.  Increase  CD6  by  1  and  store  in  CD7* 

i.  Pick  up  the  instructions  in  the  user's  program  using  CD2  and  CD3. 
The  instructions  are  stored  in  IN2  and  IN2+1. 

j.  Store  the  JPR  instructions  in  the  user's  program  via  CD2  and  the 
RECOV  Subroutine  address  via  CD3. 

k.  Store  the  address  in  CD2  in  TAB  via  CD5.  Store  the  instruction 
in  IN2  in  TAB  via  CD6.  Store  the  instruction  in  IN2+1  in  TAB 
via  CD7. 
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l.  Test  Tl.  If  0  (TRAP)  go  to  step  17. 

If  1  (SNAP)  go  to  step  Ik. 

If  2  (UNSNAP)  continue. 

m.  Increase  DTR  by  2.  Pick  up  the  address  of  the  UNSTBL+1,  add  it 
to  CD4  and  store  the  bank  (whose  address  is  in  DTR)  in  the  UNSTBL 
Table  via  CD4. 

n.  Exit. 

o.  Increase  DTR  by  1.  Pick  up  the  address  of  the  SNTB+1,  add  it  to 
CD4  and  store  the  result  in  CD5.  Pick  up  the  snap  bank  (whose 
address  is  in  DTR)  and  store  it  in  SNTB  via  CID5. 

p.  Store  the  address  if  the  SX  Table  in  A2.  Test  CD4.  If  negative 
increase  A2  by  30  and  then  go  on. 

r.  Exit. 

s.  Store  the  address  of  the  TX  Table  in  A2.  Store  the  address  of 
the  TT  Table  in  DTR.  Test  CD4.  If  negative  increase  A2  by  30, 
DTR  by  50.  Pick  up  n  from  BUF+3  and  store  it  in  the  TRAP  Table 
via  DTR. 


t. 


Exit. 
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Figure  7-23  INSV 
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7. 3-7  SETUP  Subroutine  (Figures  T.2k  through  7-39) 

This  subroutine  is  used  in  setting  up  a  SNAP  or  TRAP  jump  in  the 
user's  program.  Since  a  SNAP  or  TRAP  jump  may  remain  in  the  user's  program 
throu^  meiny  iterations,  it  is  necessary  to  translate  the  saved  commands  into 
instructions  whose  relative  bank  is  the  same  as  SFCHEX. 

INSV  sets  up  the  two  parameters  which  SETUP  will  need. 

a.  T3+1  the  location  in  TAB  of  the  two  saved  cells  with  their 
corresponding  address. 

b.  A2.  The  available  location  for  the  translation  in  either  the  TX 
or  SX  Buffer. 

SETUP  divides  into  nine  modules,  each  of  which  translates  a  certain 
class  of  instructions.  These  classes  are  defined  with  regard  to  basic  simi¬ 
larities  in  their  octal  code  representations. 

For  each  module,  a  tramslation  sequence  of  instructions  is  already 
coded.  However,  SFCHEX  must  complete  those  instructions  with  the  proper 
addresses,  bank  nvunbers,  etc.  When  the  sequence  is  established,  the  subroutine 
GEN  is  used  to  transfer  the  entire  sequence  to  A2  through  A2+n,  when  n+1  is 
the  number  of  instructions . 

7.3»7-l  GEN  Subroutine  (Figure  7.24) 

As  stated  above,  this  subroutine  transfers  a  sequence  of  instructions 
from  a  module  storage  buffer  to  the  TX  or  SX  Buffer  using  the  address  in  CD4. 

GEN  uses  the  following  ceilling  sequence; 

A1  JPR 

A2  GEN 

A3  n  (number  of  instructions) 

A4  initial  address  of  instruction  sequence  in  module  buffer. 
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Procedure : 

a.  Transfer  the  contents  of  the  address  contained  in  a4  to  (21N3+1. 

b.  Transfer  the  number  in  A3  to  GENN. 

c.  Transfer  the  instruction  to  the  execution  table  via  CD4. 

d.  Increase  CD4  by  one.  (GEN3+1)  by  one. 

e.  Decrease  GENN  by  1. 

f.  Test  GENN  0  -  return 

1  return  to  step  c. 

7.3«7"2  Vfl)  Subroutine  (Figure  7-29) 

In  the  translation  of  2  cell  instructions,  it  is  sometimes  necessary 
to  go  down  into  the  user's  program  and  pick  up  the  second  cell.  This  is  done 
through  the  WT  Subroutine.  Its  calling  sequence  is: 

1  JPR 

2  WT 

The  A-Register  must  contain  the  address  in  the  module  translation 
buffer  in  vhich  the  cell  is  to  be  stored. 

Procedure : 

a.  Store  the  address  in  the  A-Register  in  WTl+3- 

b.  Test  CD6.  0  means  that  we  are  currently  processing  the  first 

cell,  so  that  the  second  cell  is  already  saved  in  the 
TAB  Buffer.  Store  the  address  contained  in  SEA+1  in 
WTl+1. 

Go  to  step  e. 
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1  means  that  we  are  processing  the  second  cell  in 
the  TAB  Buffer,  and  the  next  cell  must  be  picked  up 

from  the  user's  program. 

Continue  to  step  c. 

c.  Increase  EXIT  by  1  via  CD9,  so  that  return  to  SFCHEX  will  occur 
one  cell  past  the  cell  we  are  picking  up. 

d.  Pick  up  cell  in  user's  program  via  CD5.  Go  to  step  g. 

e.  Set  CD6  to  1  (this  will  indicate  that  the  second  cell  has  been 
processed. ) 

f .  Pick  up  the  second  cell  which  was  stored  in  the  TAB  Buffer  via 
WTl+1. 

g.  Store  the  cell  at  the  address  contained  in  WTI+3. 


h. 


Return . 
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Figure  7.24 


GEN 
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7. 3. 7. 3  SETUP  Module  Control  Sequence  (Figure  7.26) 

This  section  analyzes  the  cell  to  be  translated  and  transfers  control 
to  the  proper  module.  SETUP  will  be  provided  with  the  locations  of  the  cells 
to  be  translated  and  the  place  in  the  TX  or  SX  Buffer  where  the  translation 
is  to  be  stored  (A2). 

a.  Store  0  in  CD9  (Translating  first  cell).  Store  the  contents  of 
A1  (address  of  first  instruction  in  TAB)  in  SEA+1.  Pick  up  the 
first  instruction  via  SEA+1.  Store  in  GDI. 

b.  Divide  the  cell  into  the  E  anf  F  fields.  E  goes  to  CD2  and  F 
to  CD3. 


Test  CD  3 


0  -  go  to  step  j , 

non  0-  continue. 


d.  Test  CD3  If  CD3  is  greater  than  70  go  to  step  m. 

If  CD3  is  less  them  or  equal  to  70  continue. 

e.  Test  CD3  If  CD3  is  less  than  60  go  to  step  f. 

If  CD3  is  greater  than  or  equal  to  60  we  have  a 
conditional  Jump  instruction  since  CD3  is  greater 
than  60  and  less  thsui  JO  or  a  JPI  instruction  if 
CD3  equals  JO.  Both  these  types  of  commands  are 
handled  in  Module  2.  (Section  7.3.7.3.2). 

Test  the  complete  cell  (CDl)  for  0101.  This  would  be  a  PTA 
instruction.  If  the  test  is  negative, go  to  step  g,  otherwise 
go  to  Module  9  (Section  7- 3. 7* 3 -9)  for  the  PTA  translation. 

Test  the  complete  cell  (CDl)  for  0100  (BLS).  OIO5  (ATE)  or 
0106  (ATX).  If  the  tests  are  negative,  go  to  step  h,  otherwise 
go  to  Module  7  (Section  J.3-7’3-7)- 


f . 
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h.  Teat  the  complete  cell  (CDl)  for  0104  (CDC)  or  OI3O  (CIL).  If 
the  tests  are  negative,  go  to  step  .1,  otherwise  go  to  EXl.  These 
arc  illegal  commands  and  EXl  will  point  on  the  typewritoi*  "IL 
INST  AT  bXXXX",  then  SFCffiiX  halts, 

i.  Test  the  complete  cell  (CDl)  for  the  format  015X  (STP)  instruction. 
If  the  test  Is  negative,  the  cell  contains  a  command  which  is 
translated  by  Module  1  (Section  T*3-T-3-l)-  If  the  test  is  posi¬ 
tive,  the  STP  instruction  is  translated  by  Module  0  (Section 

7-3. 7. 3.0). 

J.  (F  =  0  in  step  c)  Test  CD2 

0  -  means  we  have  a  HLT  Command.  This  is  illegal.  EXl  is  called 
and  SFCHEX  halts. 

Non-0,  continue. 

k.  Test  CD2,  If  CDS  is  not  greater  than  seven,  go  to  Module  1. 

(This  is  a  NOP).  If  CD2  is  not  greater  than  seven  -  continue. 

l.  Shift  the  contents  of  CDS  eight  jjlaces  to  the  left.  If  the 
result  is  negative,  the  cell  contains  a  bank  set  and  Jump.  This 
instruction  is  translated  by  Module  5*  (Section  7*3.7"3*5)'  If 
the  result  is  positive,  the  cell  contains  a  bank  Instruction. 

This  will  be  translated  by  Module  6.  (Section  7*3*7*3-6). 

m.  (CD3  greater  than  70  in  step  d). 

Test  CD3.  If  CD3  equals  Jl  and  CD2  equals  0,  we  have  an  illegal 
instruction  (JPR).  EXl  will  print  its  comment  and  SFCHEX  will 
halt.  If  CD3  equals  71  and  CD2  doesn't  equal  0,  we  have  a  JFI 
command  which  is  translated  by  Module  3  (Section  7*3.7*3>3)"  If 
CD3  doesn't  equal  71/  continue  to  step  n. 
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n.  Finally,  test  the  cell  (CDl)  for  a  77X0  (SLJ).  If  the  test  is 
negative,  we  have  an  illegal  instruction,  EXl  prints  its  conment 
and  SFCHEX  halts. 

If  the  test  is  positive,  Module  4  (Section  7*3'7-3-4)  translates 
the  SLJ  Coinmand. 

o.  Each  time  a  Module  completes  a  translation,  it  returns  to  ALPHA 
(upper  left  portion  in  Figure  7-26).  ALPHA  is  step  p. 

p.  Test  CD6.  0  -  means  another  cell  to  translate.  Set  CD6  to  1, 
return  to  step  2. 

1  -  means  the  second  cell  has  been  translated.  At  this  time 
a  final  sequence  of  commands  which  make  sure  that  when  the 
translation  is  executed  the  final  instruction  will  transfer  to 
A31  in  PREX,  is  stored  via  CD4. 

q.  Return. 


CQ 
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7-3.7. 3-1  MODULE  1  (Figure  7-27) 

This  module  translates  Relative  Instructions,  Constant  Instructions, 
Two  Word  Instructions  other  than  constajit  and  any  other  instructions  not  handled 
by  the  other  Modules. 

Procedure : 

a.  Set  the  translation  exit  so  that  the  result  in  the  A-register 
will  be  saved.  This  is  done  by  storing  A31  through  CD12. 

b.  Pick  up  the  imits  digit  of  CD2,  store  the  result  in  CDI3. 

c.  Test  the  instruction  for  form  OXXX.  If  the  test  is  negative,  go 
to  step  d.  If  the  test  is  positive,  go  to  Module  1.1. 

d.  Test  CD3.  If  CD3  does  not  equal  0,  we  have  a  relative  mode, 
direct  or  indirect  instruction,  treated  in  Module  1.2.  If  CD3 
equals  0  -  continue. 

e.  If  CDI3  equals  3  or  T,  go  to  Module  1.1  (this  indicates  a  speci¬ 
fic  command  since  E  equaled  O). 

f.  If  CDI3  equals  2  or  6,  go  to  Module  1.4  (this  indicates  a  con¬ 
stant  command). 

g.  Otherwise  we  have  a  two  word  instruction  which  is  handled  by 
Module  1.3. 
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Figure  7.27  MODULE  1 
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7.3.7-3.1-1  MODinJi:  1.1  (Figure  7-28) 

This  section  translates  all  the  single  cell  arithmetic,  direct 
and  specific  instructions.  The  translation  sequence  for  euiy  such  command  is 


TI3 


SIC  SFCHEX  Relative 
+1  LDM 

+2  BN3  (BN3  is  a  SIC  to  the  user's  current 
+3  STF3  indirect  setting) 

+k  LDM 

+5  SA  (user's  A-Register) 

+6  0  (stored  from  above) 

+7  INSTRUCTION 

+8  SIC  SFCHEX  Relative 

+9  STM 

+10  SA  (new  user's  A-Register) 


The  procedure  is: 

a.  Store  CDl  in  T13'''7' 

b.  Call  GEN  with  a  calling  sequence  of  11,  T13' 

c.  Return  to  ALPHA  (Figure  7"26). 


t 
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Figure  7.28 


MODULE  1.1 
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7. 3. 7. 3. 1.2  MODULE  1.2  (Figure  7.29) 

This  section  tremslates  all  relative  mode  instructions.  The  trems- 
lation  sequence  for  any  such  command  is: 


Til 

SIC 

UR  (User's  Relative) 

+1 

XXM 

(Change  the  relative  command  to  a  memory 

command) 

+2 

(p) 

1  E 

+3 

SIC 

SFCHEX  Relative 

+4 

STM 

+5 

SA 

Procedure : 

a.  If  CDI3 

=  200,  600  Subtract  100  from  SCI  and  store  it  in 

Tll+2.  This  changes  the  relative  forward  instructions  to  a 
memory  instruction.  Go  to  step  d. 

b.  If  CDI3  =  300,  700  Subtract  200  from  CDl  and  store  in  Tll+1. 
This  changes  the  relative  backward  instruction  to  a  memory  in¬ 
struction.  Go  to  step  e. 

c.  If  CDI3  was  neither  of  the  above,  go  to  Module  1.1. 

d.  Add  CD5  (the  address  of  the  instruction)  and  CD3  (the  E  field) 
Store  in  Tll+2.  Go  to  step  h. 

e.  Subtract  CD3  from  CD5,  store  in  Tll+2. 

f.  Store  the  SIC  UR  in  Til. 

g.  Cedi  GEN  with  sequence  6,  Til. 

h.  Go  to  ALPHA. 
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7. 3. 7. 3. 1.3  MODULE  1.3  (Figure  7-30) 

This  section  translates  constant  mode  instructions.  The  trans¬ 
lation  sequence  for  such  a  command  is: 

Til  INSTRUCTION 

+1  2nd  CDLL  obtained  by  WT  Subroutine 

+2  SIC  SFCHEX  Relative 

+3  STM 

+4  SA  Save  A-Register 

Procedure : 

a.  Store  CDl  in  Til. 

b.  CALL  WT  with  address  Tll+1  in  the  A-Register. 

c.  CALL  GEN  with  calling  sequence  5,  Til. 

d.  Go  to  ALPHA. 
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Figure  7*30 


MODULE  1.3 
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7.3.7.3-IA  module  lA  (Figure  7.31) 

This  section  translates  the  memory  instructions.  The  translation 

sequence  is: 


ti4  instruction 

+1  Second  cell  using  WT. 

+2  SIC  SFCHEX  Relative. 

+4  STM 

+5  SA  Save  A-Register. 

The  procedure  is : 

a.  Store  CDl  in  Tl4. 

b.  Call  WT  Subroutine  with  Tl4+1  in  the  A-Register. 

c.  Call  GEN  with  cabling  sequence  Tl4. 

d.  Go  to  ALPHA. 
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Figure  T.3I 


MODULE  1.4 
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7. 3. 7. 3-2  MODULE  2  (Figure  7-32) 

This  module  translates  conditional  jumps  and  the  JPI  command.  The 
translation  sequences  are: 

CON.  JUMP 


T21 

SIC 

SFCHEX 

BANK 

+1 

XXF 

2 

Same  condition  as  INST 

+2 

YYF 

7 

Opposite  condition 

+3 

LDC 

+1; 

(P)  +  (E) 

Jump  address 

+5 

STM 

SFCHEX  will  return  to 

+6 

EXIT 

the  address  in  EXIT 

+7 

JFl 

1 

+8 

A32 

Current  A-Register  won't  be  saved, 

JPI 

INSTRUCTION 

T22 

SIC 

SFCHEX 

BANK 

+1 

LDD(E) 

+2 

STM 

SFCHEX  will  return  to  the 

+3 

EXIT 

address  in  EXIT. 

+4 

JFI 

1 

Current  A-register  won't 

+5 

A32 

be  saved. 

Procedure : 

a.  Test  CD2.  CD2  less  than  6400  means  a  conditional  forwaird  jump 
Store  CD5  +  CD3  in  T21+^.  Go  to  step  e. 

b.  Test  CD2.  CD2  =  7OOO  means  a  JPI  instruction  -  go  to  step  i. 

c.  If  the  above  tests  fail,  we  have  a  conditional  backward  jump. 
Store  CD5  -  CD2  in  T21+4. 
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d.  Subtract  400  from  CD2.  This  makes  it  a  relative  forward  jump. 
Store  the  result  in  CD2. 

e.  Add  2  and  store  in  T21+1. 

f.  Shift  CD2  by  5.  Test  result. 

Negative  -  Add  0107  to  CD2  and  store  in  T21+2. 

Positive  -  Subtract  0071  from  CD2  and  store  in  T21+2. 

The  result  is  the  opposite  conditional  jump. 

g.  Call  GEN  with  ceilling  sequence  9-  T21. 

h.  Go  to  ALPHA. 

i.  Add  2000  to  CD3,  this  will  be  a  LDD  Commeuid.  Store  the  result 
in  T22+1. 

j.  Call  GEN  with  calling  sequence  6,  T22. 

k.  Set  CD6  to  1,  since  it  will  be  unnecessary  to  translate  a  second 
instruction. 

l.  Go  to  ALPHA. 
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Figure  7.32  MODUI£  2 
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7. 3. 7. 3. 3  MODULE  3  (Flpure  7-33) 
This  module  translates  • 

quence  is: 

T31 

+1 

+2 

+3 

+4 

+5 

+6 

Procedure : 

a.  Add  (CD6)  to  (CD3) 


.he  JFI  instiniction.  The  translation  se 

LDC 

(p)  +  (E) 

SIC  SFCHEX  BANK 

STM 

EXIT 

JFI  1 

A32 


and  store  in  T31+1- 


b.  Call  GEN  with  calling  sequence  7,  T31. 

c.  Set  CD6  to  1. 

d.  Go  to  ALPHA. 
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Figure  7.33 


MODUI£  3 
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T.3.7-3-'+  MODULE  4  (Figure  7-34) 

This  module  translates  the  SLJ  Instruction.  The  translation  sequence 


t4 

INSTRUCTION 

+1 

++3 

Just  jump  to  t4+4  if  condition  holds. 

+2 

NZF 

9 

These  two  instructions  get  out  of  this 

+3 

ZJF 

8 

sequence . 

+4 

SIC 

SFCHEX 

BANK 

+5 

LDC 

0 

+6 

G 

Obtained  by  VJT 

+7 

STM 

+8 

EXIT 

+9 

JFI 

1 

+10 

A32 

Procedure : 

a .  Store 

GDI  in  t4.  Store  the  address  in  CD4  increased  by  4. 

t4+1  for  the  jump  to  T^+4  in  the  execution  table. 


b.  Call  WT  to  pick  up  second  cell  (t4+6  in  A-Register) 

c.  Call  GEN  with  calling  sequence  11.  t4. 

d.  Return  to  ALPHA. 
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Figure  7.34 


MODUIE  4 
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7.3. 7. 3. 5  MODULE  9  (Figure  7-39) 

This  module  translates  bank  sets  and  jumps.  The  translation  sequence 
is : 


T5 

LDM 

+1 

BN3 

Users 

current  bank 

+2 

STF 

3 

+3 

LDM 

+4 

SA 

+5 

0 

+6 

CIL 

Since 

the  jump  will  be  made  directly, 

the  interrupt  lockout  set  by  RECOV 
is  removed. 


+7  INSTRUCTION 

Procedure : 

a.  Store  CDl  in  T5+7* 

b.  Call  GEN  with  calling  sequence  8,  T5‘ 


Go  to  ALPHA. 
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Figure  7.35 
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7.3-T.3-6  MODULE  6  (Figure  7.36) 

This  module  translates  the  bank  set  instructions .  The  translation 
seq.uence  is : 


t6  instruction 

+1  CTA 

+2  SIC  SFCHEX  BANK 
+3  STM 

+4  BC  Bemk  settings  for  return  to  user's 
program. 


Procedure : 

a.  Store  CDl  in  t6. 

b.  Call  GEN  with  calling  seq,uence  5,  t6. 

c.  Go  to  ALPHA. 


V 
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Figure  7.36  MODULE  6 
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7-3.7-3.7  MODULE  7  (Figure  7.37) 

This  module  translates  BLS,  ATE  and  ATX  instructions.  The  trans¬ 
lation  sequence  is: 

T7 
+1 
+2 
+3 
+4 

+5 
+6 

+7 
+8 

+9 
+10 

Procedure : 

a.  Store  GDI  in  T7. 

b.  Store  the  address  in  CD4  increased  by  4  in  T7+1  for  the  jump 
to  T7+4  in  the  execution  table. 

c.  Call  VT  with  T7+6  in  the  A-Register. 

d.  Call  GEN  with  calling  sequence  11,  T7. 

e.  Go  to  ALPHA. 


INSTRUCTION 

*+3 

Just  jump  to  T7+4  if  exit  occurs 

JFI 

1 

12 

SIC 

SFCHEX 

BANK 

LDC 

G 

Obtained  by  WT 

STM 

EXIT 

JFI 

1 

A32 

1 
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Figure  7.37 


MODUI£  7 
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7.3-T-3-8  MODULE  8  (Figure  7-38) 

This  module  translates  the  STP  Instruction.  The  translation  se¬ 
quence  is: 

T8  STF  5  Save  A-Register 

+1  LDC 
+2  (P) 

+3  STD  5X 

+4  LDC 
+5 


Procedure : 

a.  Store  the  address  of  P  contained  in  CD5  in  t8+2. 

b.  Add  4000  to  CD3  and  store  in  t8+3- 

c.  Call  GEN  with  ceulllng  sequence  6,  t8. 

d.  Go  to  ALPHA. 


1 
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Figure  7*38 


MODULE  8 
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7. 3. 7. 3-9  MODULE  9  (Figure  7.39) 

This  module  translates  the  PTA  instruction.  The  translation  se¬ 
quence  is: 


T9 

SIC 

SFCHEX  BANK 

+1 

LDC 

+2 

(P) 

+3 

STM 

SA 

Procedure : 

a.  Store  the  address  in  P  contained  in  CD5  in  T9+2. 

b.  Call  GEN  with  calling  sequence  5,  T9. 

c.  Go  to  ALPHA. 
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Figure  7.39 


MODULE  9 
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7.3*8  UNST  Subroutine  (Figure  7-^0) 

This  subroutine  may  be  called  with  the  parameters  stored  in  the 
BUF  Buffer  or  a  TRAP  Table.  In  either  case  the  parameters  axe  stored  in  the 
following  order: 


A1 

bank  1 

A2 

address 

1  (to  place  the  j\mip  to  RECOV) 

A3 

bank  2 

a4 

address 

2  of  snap  commeind  to  be  removed 

Procedure : 

a.  Set  T3+1  to  6  and  T1  to  1.  This  is  for  INSV  Subroutine. 

b.  Store  -5  in  the  TRAP  Table  via  DTR.  This  will  cause  the  next 
trap  execution  to  skip  this  parameter.  If  UNST  was  called  from 
the  BUF  Buffer  no  harm  will  be  done. 

c.  Call  INSV  subroutine. 

d.  Return. 
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Figure  7A0 


UNST 
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7.3'9  Mnemonic  Dump  Subroutine  (Figure  7-^1) 

This  subroutine  can  be  csilled  directly  from  the  input  section  or 
from  a  trap  table.  The  sequence  of  setup  parameters  is  the  same  in  each  case. 


A1 

bank 

-  bank  number 

A2 

address 

-  start  of  dump 

A3 

zero 

-  unused 

a4 

number 

-•  number  of  60  word  blocks 

The  procedure  is : 

a.  The  address  A1  is  contained  in  DTE.  The  Bank  number  is  stored 
into  DUMAD  via  D. 

b.  Increase  DTE  and  D1  by  1.  Store  address  in  DUMAD+1  via  Dl. 

c.  Increase  DTE  +  Dl  by  1.  Store  0  into  DUMAIH2  via  Dl. 

d.  Increase  DTE  +  Dl  by  1.  Store  number  into  DUMAD+3  via  Dl. 

e.  The  UNNEED  Subroutine  is  called  in  case  the  dump  is  in  the 
direct  bank. 

f.  The  line  is  output. 

g.  DUMAD+1  is  increased  by  60  and  stored  in  the  output  command. 

h.  DUMAD+3  is  decreased  by  1. 

i .  Test  DUMAD+3 

0  -  Call  NEED  Subroutine  and  exit. 

/  0  -  Go  back  and  print  next  image. 
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Figure  ^4-1 


Mnemonic  Dump  Subroutine 
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7 A  ENTRY  Subroutine  -  TRAP,  SNAP  or  UNSNAP  Execution  (Figure  7^2) 

Procedure : 

a.  Store  bajik  settings  in  BC. 

b.  Call  NEED  Subroutine  to  save  user's  direct  cells  and  to  store 
SFCHEX'  direct  cells. 

c.  Set  indirect  bank  to  user's  relative  bank. 

d.  Find  address  of  flagged  jump  +2  and  store  in  DP. 

e.  Pick  up  contents  of  user's  A-Register  and  store  in  TSA. 

f.  Put  final  user's  bank  controls  in  BC. 

g.  Transfer  DP  to  EXIT,  decrease  DP  by  2,  store  TSA  in  SA. 

h.  Set  DE2  to  0.  Store  the  address  of  TAB  Table  in  DTAB. 

i.  Store  -1  in  DEI. 

j .  Compare  the  address  in  the  TAB  Buffer  (via  DTAB)  with  the 
address  in  DP.  If  equal  go  to  step  m,  otherwise  continue. 

k.  Increase  DTAB  by  3,  increase  Iffil  by  1. 

l.  If  DE1=0,  return  to  step  10. 

If  DE1=1,  Increase  DE2  by  1  and  go  to  step  9* 

m.  At  this  time  we  have  found  the  matching  address.  The  contents 
of  DE2  will  tell  SFCHEX  what  kind  of  command  is  to  be  dealt  with. 

DE2=0  TRAP 

DE2=1  UNSNAP 

DE2=2  SNAP 
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7.4.1  TRAP  Execution  Section  (Figure  7-43) 

This  section  locates  the  proper  TRAP  TABLE  (in  TT  Buffer)  and  TRAP 
Instruction  Execution  Table  (in  TX  Buffer)  and  then  executes  them. 

Procedure ; 

a.  Store  initial  address  of  TX  Buffer  in  DE4.  Store  initial  address 
of  TT  Buffer  in  DTR. 

b.  If  DEI  equals  zero,  go  to  step  d^  otherwise  continue. 

c.  Increase  DE4  by  3O)  DTR  by  50- 

d.  Are  the  contents  of  the  address  in  DTR  equal  to  -1.  Yes  -  this 
is  an  infinite  trap,  go  to  step  e.  No  -  decrease  the  contents 
of  DTR  by  one  via  DTR. 

e.  Store  the  contents  of  the  address  in  DTR  in  EN12+1.  Increase 
DTR  by  one. 

f.  Check  the  contents  of  the  address  stored  in  DTR  for  7777.  If 
1117)  the  TRAP  execution  is  finished,  go  to  step  10.  If  not 
7777}  test  the  value  for  less  than  0  and  greater  than  -20.  If 
this  condition  doesn't  hold,  go  to  step  i. 

g.  If  the  value  is  -M,  where  M  is  less  than  20,  this  means  that 
a  SNAP,  UHSNAP  or  CORRECT  command  was  executed  previously  for 
this  TRAP  Table. 

h.  Add  M  to  the  address  in  DTR.  Return  to  step  f . 

i.  DTR  contains  the  address  of  some  subroutine  (DUMP,  HEAD,  UNST, 
SNST,  correct).  Transfer  to  that  subroutine.  (Note  the  sub¬ 
routine  will  modify  DTR  so  that  it  contains  the  next  address 
to  be  considered  in  the  TRAP  Table . )  When  subroutine  returns 
control,  return  to  step  f. 
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j.  The  TRAP  Table  has  been  executed.  Check  the  value  in  EN12+1 
(the  TRAP  iteration  counter).  If  0,  the  trap  has  been  flushed, 
go  to  step  k.  Otherwise  return  to  the  user's  program  via  PREX 
which  will  execute  the  instructions  at  the  address  contained  in 
DE4  (in  TX  Buffer). 

k.  Call  REPLAC  (Section  This  subroutine  replaces  the  con¬ 

tents  of  the  cells  which  were  taken  from  the  user's  program. 
Switches  are  set  so  that  the  TRAP  command  is  obliterated. 

l.  Test  NOPUT  Switch.  0  -  more  input  -  go  to  BETA  ajid  input  next 

commands .  1  -  no  more  input  -  continue . 

m.  Test  TERM  Switch. 

1  -  go  to  step  n. 

0  -  cadi  UNMEED  Subroutine  and  go  to 
A32  in  PREX  for  return  to  user's 
program. 

n.  Test  DEI 

If  -1,  test  the  contents  of  TT+50 
If  0,  test  the  contents  of  TT. 

(Since  one  trap  has  just  flushed,  we  need  only  check  the  N  cell 
in  the  other  TRAP  Table  for  7777  or  0 . ) 

If  7776  or  0,  stop. 

Otherwise  call  UNNEED  Subroutine  euid  go  to  A32  in  PREX  for  return 
to  user's 


program. 
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7.4. 2  UNSMF  EX  (Figire  7.kk) 

This  section  removes  a  snap  address  from  the  TAB  Buffer  and  re¬ 
places  the  saved  instructions  in  the  user's  program  at  both  the  SNAP  and  UNSNAP 
jump  locations. 

The  contents  of  DEI  will  tell  which  of  the  addresses  in  the  UNSTBL 
is  to  be  used  in  removing  the  SNAP  COMMAND. 

Procedure ; 

a.  Cadi  REPLAC.  DTAB  will  indicate  the  set  of  cells  and  corres¬ 
ponding  address  which  are  to  be  replaced.  This  takes  care  of 
the  UNSNAP  jump  address. 

b.  Set  the  initial  address  (plus  12)  of  TAB  in  DTAB.  Pick  up  the 
SNAP  address  from  UHSTBL+DEl  and  store  it  in  CDl. 

c.  Compare  the  address  in  UNSTBL  (via  CDl)  with  the  cell  in  TAB 
whose  address  is  in  DTAB.  If  equal,  then  the  address  is  found, 
go  to  step  e.  If  unequal,  increase  DTAB  by  3  and  continue. 

d.  Test  DTAB.  If  equal  to  I8,  an  erroneous  UNSNAP  coranand  was 
entered,  since  no  match  can  be  found.  The  following  message 
will  appear  on  the  typewriter.  "NO  S  AT  BXXXX" .  Then  SFCHEX 
will  halt.  Otherwise  return  to  step  d. 

e.  Call  REPLAC.  The  saved  instructions  will  be  stored  at  the  SNAP 
jvimp  address. 

f.  Go  to  A32. 


Figure  7-4^^  UNSNAP  EX 
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7.4.3  SNAP  EX  (Figure  7-49) 

This  section  sets  up  the  execution  of  the  SNAP  dump. 

Procedure : 

a.  Pick  up  the  snap  bank  from  address  SNPTBL+(DE1) .  Store  the  re¬ 
sult  in  GDI . 

b.  Call  SNAP  (Section  7<’4.6)  -  a  snap  dump  ensues. 

c.  Put  the  initial  address  of  SX  in  DE4. 

d.  Test  DEI  -  1  -  DE4  continue  the  address  of  the  right  translation 
sequence.  Go  to  PREX. 

e.  Increase  DE4  by  30,  and  go  to  PREX. 
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Figure  7-^5  SNAP  EX 
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7.4.4-  PBEX  (FlRure  7.46) 

This  subroutine  has  two  entry  points.  The  main  entry  (PREX) 
causes  a  translation  sequence  (initial  address  in  DE4)  to  be  executed.  A32  is 
entered  when  no  instructions  are  executed.  This  will  result  in  the  A-Register 
and  banks  being  restored  and  a  return  made  to  RECOV. 

Procedure ; 

a.  Call  UNKEED  Subroutine  in  order  to  return  user's  direct  cells. 

b.  Set  the  banks  and  A-Register  as  they  were  in  the  user's  program. 

c.  JFI  to  the  address  in  DE4. 

Note:  There  are  two  possible  returns  from  step  c.  A31  or  A32. 

d.  Store  the  present  contents  of  the  A-Register  in  SA. 

e.  Store  the  contents  of  the  SA  in  the  RECOV  Subroutine. 

f .  Store  the  contents  of  EXIT  in  RECOV. 

g.  Set  the  banks  and  jump  to  RECOV. 
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7.4.5  REPLAC  (Figure  7.47) 

This  subroutine  replaces  the  instructions  which  were  saved  in  the 
TAB  Buffer  as  the  result  of  a  SNAP,  UNSNAP,  or  TRAP  command. 

DTAB  will  contain  the  address  of  the  location  in  TAB  of  that  three 
cell  group  containing  an  address  in  the  user's  program  and  the  2  saved  cells. 

Procedure ; 

a.  Pick  up  the  address  stored  in  DTAB  and  store  it  in  CDl. 

b.  Pick  up  the  user's  program  address  via  CDl  and  store  it  in  CD2 
and  EXIT. 

c.  Store  a  7777  in  TAB  via  CDl.  This  will  allow  subsequent  commands 
to  use  the  space. 

d.  Increase  CDl  by  one.  Pick  up  the  first  saved  instruction  in  TAB 
and  store  it  in  CD3. 

e.  Increase  CDl  by  one.  Pick  up  the  second  saved  instruction  in 
TAB  and  store  it  in  CD4. 

f .  Set  the  indirect  bank  to  the  user's  relative. 

g.  Store  the  contents  of  CD3  in  the  user's  program  via  CD2.  In¬ 
crease  CD2  by  one,  and  store  the  instruction  in  CD4  in  the  user's 
program. 

h.  Reset  the  indirect  bank  and  exit. 
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SNAP  (Figure  7-48) 

The  SNAP  Subroutine  sets  up  a  special  calling  sequence  for  the 
DUMP  Subroutine.  The  bank  to  be  snapped  will  be  in  the  A- Register.  If  the 
A-Register  contains  a  h,  all  the  banks  will  be  snapped. 


Recall 

the  DUMP  Calling  Sequence 

Parallel  SNAP  Sequence 

A1 

bank  1 

SNPBS  — 

bank 

A2 

address  1 

Lower  Limit 

0 

A3 

bank  2 

SNPBT  ---- 

(same  bank) 

a4 

address  2 

Upper  Limit 

77 

Procedure : 

a.  Store  A-Register  in  SNPIO. 

b.  Does  A-Register  equal  4. 

No  -  go  to  step  d. 

Yes-  continue  to  step  c. 

c.  Store  3  in  SNPIO  ajid  set  0  in  A-Register. 

d.  Store  A-Register  in  both  SNPBS  and  SNPBT  and  store  the  address 
SNPBS  in  DTR  for  the  DUMP  Subroutine. 

e.  CALL  DUMP. 

f.  Subtract  SNPBS  from  SNPIO. 

0  -RETURN 

Non-O-go  to  step  g. 

g.  Increase  SNPBS  by  1  and  leave  the  result  in  the  A-Register.  Go 
to  step  d. 
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